From 41d56498e93226faab48a2d9a70843dc0036dc29 Mon Sep 17 00:00:00 2001 From: Artyom Keydunov Date: Tue, 7 Apr 2026 18:23:40 -0700 Subject: [PATCH 1/3] docs(mintlify): add Folders page to Organize content section Made-with: Cursor --- docs-mintlify/docs.json | 6 + .../docs/organize-content/folders.mdx | 145 ++++++++++++++++++ 2 files changed, 151 insertions(+) create mode 100644 docs-mintlify/docs/organize-content/folders.mdx diff --git a/docs-mintlify/docs.json b/docs-mintlify/docs.json index 469603d5934bf..ce7cef0c06605 100644 --- a/docs-mintlify/docs.json +++ b/docs-mintlify/docs.json @@ -69,6 +69,12 @@ "docs/explore-analyze/notifications" ] }, + { + "group": "Organize content", + "pages": [ + "docs/organize-content/folders" + ] + }, { "group": "Data Modeling", "pages": [ diff --git a/docs-mintlify/docs/organize-content/folders.mdx b/docs-mintlify/docs/organize-content/folders.mdx new file mode 100644 index 0000000000000..66ae792b065d8 --- /dev/null +++ b/docs-mintlify/docs/organize-content/folders.mdx @@ -0,0 +1,145 @@ +--- +title: Folders +description: Organize workbooks, dashboards, and explorations into a hierarchical folder structure for easy navigation and access control. +--- + +As your team creates workbooks, dashboards, and explorations, folders help you +keep content organized and easy to find. Folders provide a hierarchical +structure that mirrors how your team thinks about its data — by team, +project, domain, or any other grouping that makes sense. + +## Creating folders + +To create a folder: + +1. Navigate to the **Workspace** page. +2. Click **New folder**. +3. Enter a name for the folder (up to 255 characters). +4. Click **Create**. + +You can also create folders inside existing folders to build a nested +hierarchy. Open the parent folder first, then follow the same steps. + + + +Folder names must be unique within the same parent folder. + + + +## Nesting folders + +Folders support up to **10 levels** of nesting, allowing you to build +detailed hierarchies. For example: + +```text +Workspace (root) +└── Marketing + └── Campaigns + └── Q1 2025 + └── Email Performance +``` + +Each level provides further categorization while keeping content accessible +through the folder tree. + +## What can go in a folder + +Folders can contain the following content types: + +- **Workbooks** — multi-tab analyses built with the semantic layer or + source SQL +- **Dashboards** — published views of workbook reports +- **Explorations** — saved explorations from Analytics Chat or the Explore + page + +Content that is not placed in a folder appears at the root level of your +workspace. + +## Moving content into folders + +To move a workbook, dashboard, or exploration into a folder, open the +item's action menu and select **Move**. Choose the target folder from the +folder picker and confirm. You can also move items to the root level by +selecting the workspace root as the destination. + +## Renaming folders + +To rename a folder: + +1. Open the folder's action menu. +2. Select **Rename**. +3. Enter the new name. +4. Click **Save**. + + + +The new name must be unique within the same parent folder. + + + +## Moving folders + +You can rearrange your folder hierarchy by moving folders to a different +parent: + +1. Open the folder's action menu. +2. Select **Move**. +3. Choose the new parent folder (or the workspace root). +4. Confirm the move. + + + +A folder cannot be moved into one of its own subfolders. + + + +## Deleting folders + +To delete a folder: + +1. Open the folder's action menu. +2. Select **Delete**. + + + +A folder can only be deleted if it contains no subfolders. Move or delete +any subfolders first. + + + +## Folder permissions + +Folder access is controlled through three permission levels: + +| Permission | Allows | +| --- | --- | +| **Read** | View the folder and its contents | +| **Edit** | Rename the folder, move content into it, and create subfolders | +| **Manage** | Full control including moving and deleting the folder, and managing folder permissions | + +The creator of a folder automatically receives **Manage** permission. + +### Permission inheritance + +Permissions propagate down the folder tree. When a user is granted access +to a folder, they also gain access to all of its subfolders. The closest +folder in the hierarchy determines the effective permission level — a +permission set on a subfolder overrides the inherited permission from its +parent. + +### Folder visibility + +Users can see a folder if any of the following apply: + +- They have been granted direct access to the folder +- They have access to a parent or child folder (ancestor folders are + visible for navigation) +- They have access to content inside the folder + +This ensures users can always navigate to content they have permission to +view, even if they don't have explicit access to every folder along the +path. + +[ref-workbooks]: /docs/explore-analyze/workbooks +[ref-dashboards]: /docs/explore-analyze/dashboards +[ref-roles]: /admin/users-and-permissions/roles-and-permissions From 656a265dd8f09a1af4886cd41657e1f8ffb87ba0 Mon Sep 17 00:00:00 2001 From: Artyom Keydunov Date: Tue, 7 Apr 2026 18:28:04 -0700 Subject: [PATCH 2/3] docs(mintlify): add Share content page to Organize content section Made-with: Cursor --- docs-mintlify/docs.json | 3 +- .../docs/organize-content/sharing.mdx | 164 ++++++++++++++++++ 2 files changed, 166 insertions(+), 1 deletion(-) create mode 100644 docs-mintlify/docs/organize-content/sharing.mdx diff --git a/docs-mintlify/docs.json b/docs-mintlify/docs.json index ce7cef0c06605..7975aa69f7285 100644 --- a/docs-mintlify/docs.json +++ b/docs-mintlify/docs.json @@ -72,7 +72,8 @@ { "group": "Organize content", "pages": [ - "docs/organize-content/folders" + "docs/organize-content/folders", + "docs/organize-content/sharing" ] }, { diff --git a/docs-mintlify/docs/organize-content/sharing.mdx b/docs-mintlify/docs/organize-content/sharing.mdx new file mode 100644 index 0000000000000..82d57b487f612 --- /dev/null +++ b/docs-mintlify/docs/organize-content/sharing.mdx @@ -0,0 +1,164 @@ +--- +title: Share content +description: Share workbooks, dashboards, and explorations with specific users, groups, or your entire organization. +--- + +Sharing content with your team keeps everyone aligned on key metrics, +reduces duplicated work, and ensures stakeholders have access to the +insights they need. Cube lets you control exactly who can see and edit +each piece of content — from individual users to your entire organization. + +## What can be shared + +You can share the following content types: + +- **Workbooks** — share the full workbook including all tabs and reports +- **Dashboards** — share published dashboard views with stakeholders +- **Explorations** — share saved explorations from Analytics Chat, the + Explore page, or dashboards + + + +Shared explorations are also available to users through the +[Google Sheets][ref-google-sheets] and [Microsoft Excel][ref-excel] +integrations, allowing them to pull exploration results directly into +their spreadsheets. + + + +## Access levels + +Sharing permissions are organized into three levels: + +| Level | Description | +| --- | --- | +| **Can view** | View the content and its data | +| **Can edit** | View and modify the content | +| **Full access** | Full control including managing who the content is shared with | + +The creator of a piece of content automatically receives **Full access**. + + + +When sharing is set at the [folder level][ref-folders], content inside +the folder inherits those permissions. See +[Permission inheritance](#permission-inheritance) for details. + + + +## Sharing with users and groups + +To share content with specific people or groups: + +1. Open the workbook, dashboard, or exploration you want to share. +2. Click the **Share** button. +3. In the **Share** dialog, type a name or email in the search field to + find users or [user groups][ref-groups]. +4. Select the desired [access level](#access-levels) from the dropdown + next to the user or group. +5. Click **Invite**. + +{/* Screenshot: Share dialog showing the user/group search input, access level +dropdown, and Invite button. A user and a group should be visible in the +"People with access" list with different access levels. */} + +Invited users and groups appear in the **People with access** list. You +can change their access level or remove their access at any time from the +same dialog. + +### Changing access for existing collaborators + +To update a collaborator's access level: + +1. Open the **Share** dialog for the content. +2. Find the user or group in the **People with access** list. +3. Select a new access level from the dropdown next to their name. + +To remove access entirely, select **Remove** from the dropdown. + +{/* Screenshot: Share dialog "People with access" list showing the access level +dropdown open for one user, with "Can view", "Can edit", "Full access", and +"Remove" options visible. */} + +## Sharing with your organization + +You can make content available to everyone in your Cube Cloud account: + +1. Open the **Share** dialog for the content. +2. In the **General access** section, change the setting from **Only + people invited** to **Organization**. +3. Select the access level that all organization members should receive. + +{/* Screenshot: Share dialog with the "General access" section expanded, showing +the dropdown changed from "Only people invited" to "Organization" with a +"Can view" access level selected. */} + +When organization-wide access is set, individual users and groups can +still be granted higher access levels. For example, the organization +might have **Can view** access while a specific team has **Can edit**. + +## Permission inheritance + +Permissions flow down through the [folder hierarchy][ref-folders]. When +you share a folder, all content inside it — including workbooks, +dashboards, explorations, and subfolders — inherits the folder's +permissions. + +```text +Marketing (Full access for Marketing team) +├── Q1 Campaign Dashboard ← inherits Full access +├── Revenue Workbook ← inherits Full access +└── Weekly Reports ← inherits Full access + └── Week 1 Exploration ← inherits Full access +``` + +### How inheritance works + +- **Direct permissions override inherited ones.** If a workbook has an + explicit permission set, that takes priority over the folder permission. +- **Closest folder wins.** When multiple ancestor folders have + permissions for the same user, the nearest folder in the hierarchy + determines the effective access level. +- **Inherited permissions are visible in the Share dialog.** Users and + groups with inherited access appear in the collaborator list with an + indication of which folder the permission comes from. + +{/* Screenshot: Share dialog for a workbook inside a folder, showing the "People +with access" list where some users have a "via Marketing folder" inherited +access badge next to their access level, distinguished from users with direct +access. */} + +## Sharing folders + +Sharing a folder is the most efficient way to manage access for a +collection of related content: + +1. Navigate to the folder in the **Workspace** page. +2. Open the folder's action menu and select **Share** (or open the folder + and click the **Share** button). +3. Add users, groups, or set organization-wide access as described above. + +{/* Screenshot: Workspace page showing a folder's action menu with the "Share" +option highlighted. */} + +All current and future content added to the folder will inherit its +permissions. This makes folders ideal for organizing content by team or +project, where everyone on the team needs the same level of access. + +## Sharing explorations for spreadsheet integrations + +When you share an exploration with a user, that exploration becomes +available in the [Google Sheets][ref-google-sheets] and +[Microsoft Excel][ref-excel] add-ins. Users can browse their shared +explorations directly from the add-in and pull the results into their +spreadsheets. + +This lets analysts share governed, pre-built queries with spreadsheet +users who can refresh the data on demand without needing to use the Cube +interface. + +[ref-folders]: /docs/organize-content/folders +[ref-groups]: /admin/users-and-permissions/user-groups +[ref-roles]: /admin/users-and-permissions/roles-and-permissions +[ref-google-sheets]: /docs/integrations/google-sheets +[ref-excel]: /docs/integrations/microsoft-excel From 0b4628ded49d42dea4bd0831e41cb68226ce0d3c Mon Sep 17 00:00:00 2001 From: Artyom Keydunov Date: Tue, 7 Apr 2026 18:38:43 -0700 Subject: [PATCH 3/3] docs(mintlify): consolidate permission inheritance in Share content page Move permission inheritance and folder visibility details to the sharing page as the single source of truth. Folders page now references it. Also add screenshot placeholders to the folders page. Made-with: Cursor --- .../docs/organize-content/folders.mdx | 49 +++++++++---------- .../docs/organize-content/sharing.mdx | 13 +++++ 2 files changed, 37 insertions(+), 25 deletions(-) diff --git a/docs-mintlify/docs/organize-content/folders.mdx b/docs-mintlify/docs/organize-content/folders.mdx index 66ae792b065d8..0f244064286b6 100644 --- a/docs-mintlify/docs/organize-content/folders.mdx +++ b/docs-mintlify/docs/organize-content/folders.mdx @@ -20,6 +20,10 @@ To create a folder: You can also create folders inside existing folders to build a nested hierarchy. Open the parent folder first, then follow the same steps. +{/* Screenshot: Workspace page with the "New folder" button visible in the +toolbar and the folder name dialog open, showing the name input field and +Create button. */} + Folder names must be unique within the same parent folder. @@ -55,6 +59,10 @@ Folders can contain the following content types: Content that is not placed in a folder appears at the root level of your workspace. +{/* Screenshot: Workspace page showing a folder containing a mix of content +types — at least one workbook, one dashboard, and one exploration visible +in the list. */} + ## Moving content into folders To move a workbook, dashboard, or exploration into a folder, open the @@ -62,6 +70,10 @@ item's action menu and select **Move**. Choose the target folder from the folder picker and confirm. You can also move items to the root level by selecting the workspace root as the destination. +{/* Screenshot: The folder picker dialog that appears after clicking "Move" on +a workbook, showing the folder tree with nested folders to choose from and +a confirm button. */} + ## Renaming folders To rename a folder: @@ -71,6 +83,9 @@ To rename a folder: 3. Enter the new name. 4. Click **Save**. +{/* Screenshot: A folder's action menu (three-dot / context menu) open, showing +options including Rename, Move, Share, and Delete. */} + The new name must be unique within the same parent folder. @@ -111,35 +126,19 @@ any subfolders first. Folder access is controlled through three permission levels: -| Permission | Allows | +| Level | Allows | | --- | --- | -| **Read** | View the folder and its contents | -| **Edit** | Rename the folder, move content into it, and create subfolders | -| **Manage** | Full control including moving and deleting the folder, and managing folder permissions | - -The creator of a folder automatically receives **Manage** permission. - -### Permission inheritance - -Permissions propagate down the folder tree. When a user is granted access -to a folder, they also gain access to all of its subfolders. The closest -folder in the hierarchy determines the effective permission level — a -permission set on a subfolder overrides the inherited permission from its -parent. - -### Folder visibility - -Users can see a folder if any of the following apply: +| **Can view** | View the folder and its contents | +| **Can edit** | Rename the folder, move content into it, and create subfolders | +| **Full access** | Full control including moving and deleting the folder, and managing folder permissions | -- They have been granted direct access to the folder -- They have access to a parent or child folder (ancestor folders are - visible for navigation) -- They have access to content inside the folder +The creator of a folder automatically receives **Full access**. -This ensures users can always navigate to content they have permission to -view, even if they don't have explicit access to every folder along the -path. +To learn how to share folders with users, groups, or your entire +organization — and how permissions are inherited by content inside +folders — see [Share content][ref-sharing]. [ref-workbooks]: /docs/explore-analyze/workbooks [ref-dashboards]: /docs/explore-analyze/dashboards +[ref-sharing]: /docs/organize-content/sharing [ref-roles]: /admin/users-and-permissions/roles-and-permissions diff --git a/docs-mintlify/docs/organize-content/sharing.mdx b/docs-mintlify/docs/organize-content/sharing.mdx index 82d57b487f612..192ba413f8c95 100644 --- a/docs-mintlify/docs/organize-content/sharing.mdx +++ b/docs-mintlify/docs/organize-content/sharing.mdx @@ -128,6 +128,19 @@ with access" list where some users have a "via Marketing folder" inherited access badge next to their access level, distinguished from users with direct access. */} +### Folder visibility + +Users can see a folder if any of the following apply: + +- They have been granted direct access to the folder +- They have access to a parent or child folder (ancestor folders are + visible for navigation) +- They have access to content inside the folder + +This ensures users can always navigate to content they have permission to +view, even if they don't have explicit access to every folder along the +path. + ## Sharing folders Sharing a folder is the most efficient way to manage access for a