User Guide Getting Started Help Center Documentation Community Training
Looker
Creating and Applying Themes for Embedded Dashboards

Customizing themes for embedded dashboards is a beta feature that must be enabled by Looker. Please contact your Account Manager to update your license for this feature.

Themes are a way to customize the appearance of your embedded Looker dashboards. You can use themes to customize font family, text color, background color, and tile color.

For example, you can create a “dark” theme to really change the appearance of your embedded dashboard:

If you are a Looker admin, you can see the themes on your Looker instance by clicking on Admin at the top right of the window, scrolling down in the left panel of the Admin page, and clicking Themes:

The Looker theme is created automatically on your instance, and it cannot be deleted or edited. (You can see the settings of the Looker theme by creating a copy of the theme.)

Creating a Custom Theme

To create a custom theme, click Add Theme:

Except for the theme’s title, which must be unique, all of the fields are automatically filled in with the values from the default theme. You can change any of the settings, which are described in the Custom Theme Settings section below. Click Save to keep your changes and save your new theme.

Custom Theme Settings

When you add, edit or copy a theme, you will see the following settings:

Theme

Dashboard Page

Dashboard Tiles

Dashboard Components

Be sure to click Save to keep your theme settings.

Copying a Theme

You can copy an existing theme by clicking on the theme’s menu and selecting Copy Theme:

When you make a copy of a theme, the new theme’s name defaults to the name of the copied theme, followed by “(copy)”. Be sure to manually change this name to a new, unique name with only alphanumeric characters and underscores. Be sure to remove the parentheses.

You can edit the rest of the settings just as you would when you create a new theme. For a description of the settings, see Custom Theme Settings above. Be sure to click Save to keep all of your theme settings.

Editing a Theme

The Looker theme is created automatically on your instance, and it cannot be edited. (If you want to modify the Looker theme, you can instead create a copy of the theme and then edit the copy.)

For all other themes, you can click the associated Edit button to update theme settings:

You can edit the settings just as you would when you create a new theme. For a description of the settings, see Custom Theme Settings above. Be sure to click Save to keep your updates.

Setting a Default Theme for Embedded Dashboards

To specify the default theme for the embedded dashboards on your instance, click on a theme’s menu and select Set as Default:

The default theme is used for embedded dashboards on your Looker instance, unless you specify different settings for an individual dashboard. There are two ways to specify that an embedded dashboard should not use the default theme:

Applying a Theme to Specific Embedded Dashboards

If you want a dashboard to use a theme other than the default theme, you can specify a different theme in the URL of the embedded dashboard. To do this, add the parameter theme= with the name of the theme to the end of the embed URL. For example, if you have a theme called “Red”, you would add theme=Red at the end of your embed dashboard URL like this:

https://example.looker.com/embed/dashboards/246?theme=red

The theme element in the URL is not case sensitive, so you can use either theme=Red or theme=red.

If embed settings are applied to a dashboard, they override any custom theme specified in the embed URL. If you want to use a theme for a dashboard that uses embed settings, you can remove the dashboard’s embed settings so that you can use a custom theme.

Deleting a Theme

You can delete any theme except the Looker theme or the theme that is currently set as the default. To delete a theme, click on the theme’s menu and select Delete Theme:

After you delete a theme, any embedded dashboard with that theme specified in its URL will use the default theme.

Top