Skip to main content

Build dashboards

Themes

Choose and edit the colors and type a dashboard wears.

A theme sets how a dashboard looks: its page and card colors, its typefaces, and the colors its charts use. This page covers choosing a theme, making your own, and finding a theme's id for embedding.

Before you start​

Open a dashboard in the builder. Click an empty part of the canvas so that nothing is selected; the panel on the right then shows the dashboard's settings, including Theme.

Choose a theme​

Open the Theme section. It lists:

ChoiceWhat it does
Follow appThe dashboard wears Default Light when the app is light and Default Dark when it is dark. Picking any theme below turns this off.
Default themesDefault Light and Default Dark, the two built-in themes.
Custom themesThe themes made in your install.

Pick a theme to apply it. A theme dresses the dashboard only; the app around it keeps its own appearance.

If anything on the page has been styled by hand, GOAT asks "Switch theme?" first:

  • "Switch and reset to" followed by the new theme's name: hand styling is removed and everything follows the theme.
  • Switch and keep my styling: hand-styled elements keep their look.
  • "Stay on" followed by the current theme's name: nothing changes.

Make your own theme​

Start from a blank theme or from a copy of one:

  • Choose Add new theme to start from a blank theme. It is named "My theme 1" (or the next free number).
  • Duplicate a theme to start from it. The built-in themes cannot be changed, so duplicate one of them to make a variation.

To edit a custom theme, choose the edit button on its row. The editor opens beside the panel. Change the Theme name at the top, then the settings below:

SectionWhat it sets
PageBackground, Recessed (the fill of filters and inset controls), Lines, Accent, and On accent. Setting the background also adjusts every color you have not changed yourself.
TextThe typefaces for headings and page text, the page text size, and the heading, page text, and secondary text colors.
CardThe card that charts and filters sit in: Background, Border, Border width, Radius, Padding, Opacity, and Shadow.
ChartsSeries 1 to 5, the colors a chart's series take in order. Also Typeface, Gridlines, Axis text, Data labels, Legend & titles, and Icons.
TableCharts shown as a table: Header, Header text, Cells, Lines, and Stripes.

Changes save as you make them.

Themes are shared​

A custom theme belongs to the whole install, not to one dashboard. Every dashboard can wear it, and any author can change or delete it. A change shows on every dashboard wearing that theme.

To delete a custom theme, choose Delete in its editor. There is no confirmation. Dashboards that wore it switch to Default Light.

Find a theme's id for embedding​

Your developers can make an embedded dashboard wear a theme of their choice, rather than its own. They need the theme's id.

  • For a custom theme, the id is at the top of its editor, under Theme ID. Choose Copy ID.
  • The built-in themes' ids are default-light and default-dark.

See Embed options.

Common problems​

What you seeWhat to check
A built-in theme has no edit buttonBuilt-in themes cannot be changed. Duplicate one and edit the copy.
A dashboard's look changed though you did not touch itAnother author changed the custom theme it wears. Themes are shared across the install.
Some elements ignore the themeThey were styled by hand. Switch theme again and choose "Switch and reset to" the theme.
GOAT documentation

Type to search.