Skip to main content
You can customize the appearance of iframe-embedded Cube content in two ways:
Customization options will expand over time. This page documents what is supported today.

​
Dashboard customization

Style an individual dashboard from the Styling panel in the Dashboard Builder. Settings are saved per-dashboard and apply equally to the dashboard in Cube and to its embedded view. See Dashboards → Styling for the full list of options.

​
App customization

When embedding the full Cube app in Creator Mode, pass an embedTheme object to the Generate Session API to customize the appearance of the embedded experience. The embedTheme is scoped to the embed session — it is applied while the user is viewing the embedded app and reset on the next session generation.

​
Example

const session = await fetch(
  "https://your-account.cubecloud.dev/api/v1/embed/generate-session",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Api-Key ${API_KEY}`,
    },
    body: JSON.stringify({
      deploymentId: DEPLOYMENT_ID,
      externalId: "user@example.com",
      creatorMode: true,
      tenantId: "tenant-123",
      tenantName: "Acme Corporation",
      embedTheme: {
        analyticsChat: {
          backgroundColor: "#f4f4f5",
          chatInput: {
            backgroundColor: "#ffffff",
            borderColor: "#e4e4e7",
          },
        },
      },
    }),
  },
);

​
Parameters

The following embedTheme parameters are currently supported:
ParameterTypeDescriptionExample
analyticsChat.backgroundColorstringBackground color of the Analytics Chat panel."#f4f4f5"
analyticsChat.chatInput.backgroundColorstringBackground color of the chat input field."#ffffff"
analyticsChat.chatInput.borderColorstringBorder color of the chat input field."#e4e4e7"
All values accept standard CSS color formats (hex, rgb(), named colors).