Creator Mode is available on the Enterprise plan.
creatorMode: true to the Generate Session API.
Creator Mode requires Signed embedding. Private embedding is not supported.
Hiding features
Creator Mode ships the full authoring experience, and most of it can be taken back out for a given customer or a given placement:- Per session, via
settingson the Generate Session API:showWorkbookShare(the Share button and row actions),showDashboardSettings(the dashboard gear and its sidebar),showMemberNamesandshowGroupByCube(the data pane’s more-actions items),showWorkbookChatandshowAiWidgets(AI entry points),allowChatWorkspaceAuthoring(whether the agent may author workbooks, explorations, and dashboards at all), andallowAi(AI entirely). - Per iframe, via URL parameters:
showWorkbookBackButton=falseon the workbook header, and the dashboard header controls — which render the same in Creator Mode as in a standalone dashboard embed. - Account-wide, under Embed → Settings: the workspace header title and whether it shows at all, and whether embed users may see Semantic SQL and Generated SQL.
AI
Creator Mode workbooks show the same AI entry points as the full Cube app — the chat side panel, the launchpad’s “Ask Cube Agent” button, “Fix in chat” on a failed report, and AI summary widgets — unless you turn them off. Three account-wide switches under Embed → Settings control this, each overridable per session via Generate Session:- AI (
allowAi) is the master switch. Turning it off is enforced server-side — a denied session can’t obtain AI credentials at all, so it can’t spend AI tokens, and it overrides the toggles below. - Workbook chat (
showWorkbookChat) and AI widgets (showAiWidgets) hide those specific entry points without disabling AI as a whole. While the master switch is off, these are disabled rather than cleared, so turning AI back on restores their configured state.
allowChatWorkspaceAuthoring for headless chat integrations that shouldn’t let the agent create or modify workbooks, explorations, or dashboards.
Workspace appearance and SQL visibility
Four account-wide switches under Embed → Settings, in the Creator Mode section, control the embedded workspace’s chrome and how much of the underlying query embed users can see. Each auto-saves.- Show workspace title (
showWorkspaceTitle, boolean, defaulttrue) — whether the header row at the embedded workspace root renders at all. - Workspace title (
workspaceTitle, string, defaultWorkspace) — the header’s text; breadcrumbs reuse it as the root label. Edit titles opens per-language overrides (localizedTitles, up to 50 entries), picked from Cube’s list of supported languages — the same list the account-wide UI language is set from. - Show Semantic SQL (
showSemanticSql, boolean, defaulttrue) — lets embed users view the semantic (Cube) query behind reports and chat results. - Show Generated SQL (
showGeneratedSql, boolean, defaultfalse) — lets embed users view the generated SQL, the physical data-source query. It defaults to hidden, the opposite polarity of the switch above, because generated SQL reveals table and schema names from your data source.
Workspace rather than rendering an empty header — use Show workspace title to hide the header instead.
These are account-wide only — there’s no per-session settings key or URL parameter for any of them. Turning on Show Generated SQL doesn’t expose source tables: the workbook launchpad’s Source tables tab and the data pane’s source-schema explorer stay hidden in every embed regardless of this switch.
Embed tenant scoping
In Creator Mode, content (workbooks, dashboards) and the groups/user attributes referenced by the session are scoped to an embed tenant. PassembedTenantName to isolate content per customer; omit it to use the current tenant.
embedTenantName must be lowercase, 5–36 chars, start with a letter, end with a letter or digit, and contain only a-z, 0-9, or -.
Provisioning groups and user attributes
In Creator Mode,groups and userAttributes resolve against the embed tenant’s scoped catalog (separate from the tenant-wide one used by read-only embedding). To define those entries from your backend in the same call, pass groupDefinitions and userAttributeDefinitions — they are idempotent and validated before memberships and values are applied.
See Generate Session → Creator mode bootstrap for the input shape, value types, and the immutable-type rule on attribute definitions.
Default dashboards
You can pre-populate every embed user’s workspace with ready-made content so they see useful dashboards the first time they open the embedded app, instead of an empty workspace. This is a good way to ship templates or starter explorations that your users can open. Default dashboards are shared from your main workspace with the All embed users (all_embed_users) group — a system group that Cube creates automatically once Creator Mode is enabled. Sharing is read-only: embed users can open and explore the shared content but can’t edit it.
To set up default dashboards:
- Build the workbooks, dashboards, folders, and explorations you want everyone to see in your main workspace.
- Open the share dialog for a workbook, exploration, or folder and share it with All embed users. The only available access level is Can view.
- Embed users in Creator Mode now see the shared items at the root of their workspace as soon as they open the app.
All embed users is a system group: it can’t be renamed or deleted, and it can only be granted read-only (Can view) access. It appears automatically in Admin → User Groups and in the share dialog once Creator Mode is enabled for your workspace.
- Sharing a folder shares everything inside it — all nested folders, workbooks, and explorations become available to embed users.
- Sharing a single workbook or exploration exposes that item plus the folders above it (so users can navigate to it), but not the other contents of those folders.
- All embed users see the same default dashboards, regardless of their groups or user attributes. The shared set applies across every embed tenant that belongs to your account.
- Embed users can’t edit content shared from the main workspace. Opening a shared workbook shows its published dashboard, so a workbook must have a published dashboard for users to open it.
- Removing the share from the All embed users group removes those items from embed users’ workspaces immediately.
Sharing workbooks, explorations, dashboards, and folders
Embed users in Creator Mode can share the workbooks, explorations, dashboards, and folders they build with other users, the same way they would in the full Cube app. Sharing a folder shares everything inside it, and follows the same access levels — Full access, Can edit, Can view — as sharing a workbook.Sharing is scoped to the embed tenant: users can only share with others in the same tenant, never across tenants.