Skip to Content

Embed & Distribution

Preview and apply a theme

Check a theme on real dashboards, then choose where it applies.

Preview a theme

  1. Go to Settings > UI Theming and select Edit on the theme.

    Theme row Data Professional with the Edit button highlighted between Mark default and Delete.
    Edit opens the theme in the editor with its preview.
  2. In the Preview, choose the workspace and dashboard to show.

    Theme editor preview bar with the workspace select highlighted, set to Marketing Analytics, next to the Campaign Performance dashboard select.
    Pick the workspace and dashboard the preview shows.
  3. For a workspace with table tenancy, choose a client to see that client’s data.

    Preview bar with the Client picker highlighted, set to Cregg, next to the Data menu.
    Client shows the preview as that customer.
  4. Use the preview controls:

    • Data: show live data, or a copy saved in this browser.

    • Dark app page: show the dashboard on a dark page around it.

    • Phone width: show the dashboard at phone width.

    • Preview as Light or Dark, when Base color mode is Auto.

      Preview address bar app.yourcompany.com/analytics with the Phone width button highlighted next to the dark app page button.
      The two buttons at the right of the preview address bar switch a dark app page and phone width.

Saved changes appear in dashboards and live embeds that use this theme.

Apply a theme

An embed uses the first theme it finds, in this order:

  1. The embed code. In a data app, select Get snippet on an embed and set Appearance to Use saved theme. This adds theme-name to the snippet. The admin-theme-options option also overrides the theme.

    Embed snippet dialog with the Appearance select highlighted, set to Don't specify.
    Appearance in the snippet dialog. Use saved theme adds theme-name.
  2. The data app. In the data app, open Theme and select Customize for this data app.

    Data app Theme tab saying Using company defaults, with the Customize for this data app button highlighted.
    A data app follows its workspace theme until you customize it.
  3. The workspace. In the workspace settings, set Theme. It applies to every dashboard and embed served from the workspace.

  4. The company default. In Settings > UI Theming, select Mark default.

    Theme row Data Professional with the Mark default button highlighted.
    Mark default sets the company default theme.

Without any of these, embeds use Databrain’s default theme.

To check which theme your embeds rendered with, and whether its colors are readable, see Guest token usage.

On this page