Skip to content

docs: update spaces documentation #43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added images/references/spaces/1-view-spaces.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/references/spaces/2-view-all-spaces.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/references/spaces/3-transfer-to-space.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/references/spaces/5-add-to-space.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/references/spaces/6-edit-delete-space.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
38 changes: 18 additions & 20 deletions references/spaces.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,45 +3,43 @@ title: "Spaces"
description: "Once you've used Lightdash for a while, your team will probably end up with a lot of saved charts and dashboards. Spaces let you organize your saved charts and dashboards."
---

Spaces are kind of like folders except you can't put a Space inside of a Space (no nesting ). All saved charts and dashboards exist in a Space and can only be in one Space at a time.
Spaces are kind of like folders. All saved charts and dashboards exist in a Space and can only be in one Space at a time.

<Frame>
![](/images/references/spaces-dcc5cc3b9435883e0ef36ea4f0c2a090.png)
</Frame>
<Frame>![](/images/references/spaces/1-view-spaces.png)</Frame>

To access Spaces, you can either select a Space from the drop-down list in `Browse` or you can click on the Lightdash icon and select your Space from the homepage.

<Frame>
![](/images/references/access-spaces-674f6783cea4fffea02864351729cd9a.png)
</Frame>
<Frame>![](/images/references/spaces/2-view-all-spaces.png)</Frame>

## Moving items between Spaces

To move a saved chart or dashboard between Spaces, you can click on the three dot menu (`...`) to the right of the item and pick the `Move to Space` action.
To move a saved chart, dashboard or space between Spaces, you can click on the three dot menu (`...`) to the right of the item and pick the `Move` action. Or select items using checkboxes on the left and click `Move to Space`.

<Frame>
![](/images/references/move-between-space-0903e4e87ebf93ded0b4710031c5bc18.png)
![](/images/references/spaces/3-transfer-to-space.png)

</Frame>
<br />
<Frame>
![](/images/references/spaces/3-1-transfer-to-space-bulk.png)

You can also add items to a Space from within the Space. Just click on the `Add` button by the saved charts or the dashboards section of the page. If you select an item that's in another Space, it will get moved to the Space you're adding it to.

</Frame>
<br />
<Frame>
![](/images/references/add-within-space-d19600ecb7e73e49eed411e256a3c8fa.png)
![](/images/references/spaces/4-transfer-to-space-2.png)

</Frame>

You select multiple items to add at the same time to your Space.
You can also add items to a Space from within the Space. Just click on the `Add` button on the space page.

<Frame>
![](/images/references/add-modal-cc9dfc08cb340d9bdd98447b767b165d.png)
</Frame>
<Frame>![](/images/references/spaces/5-add-to-space.png)</Frame>

## Updating and deleting Spaces

You can rename or delete your Space on the homescreen by clicking on the three-dot menu (`...`) for the Space.
You can rename or delete your Space from All Spaces view or on the homescreen by clicking on the three-dot menu (`...`) for the Space.

<Frame>
![](/images/references/rename-delete-space-f6db364127de5e969a0b8e728c2c0f58.png)
![](/images/references/spaces/6-edit-delete-space.png)

</Frame>

Expand All @@ -53,9 +51,9 @@ Deleting a Space will delete all of the content in that Space.

## Managing access to a Space

By default, when you create a Space, it is restricted so only you can access it. You can edit a Space to make it Restricted Access or Public Access.
By default, when you create a Space, it is restricted so only you can access it (however, if you create a nested Space, it automatically inherits permissions from its parent). You can edit a Space to make it Restricted Access or Public Access.

To edit access to a Space, navigate into the Space, then click the `share` button. From there, you can choose to make a space `Restricted Access` or `Public Access`.
To edit access to a Space, navigate into the Space, then click the `share` button. From there, you can choose to make a space `Restricted Access` or `Public Access` (Only top level space access can be edited, nested spaces inherit permissions from their parent spaces).

<Frame>
![](/images/references/edit-space-access-970da236949714dbe757debce02d767f.jpg)
Expand Down