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:
| Choice | What it does |
|---|---|
| Follow app | The dashboard wears Default Light when the app is light and Default Dark when it is dark. Picking any theme below turns this off. |
| Default themes | Default Light and Default Dark, the two built-in themes. |
| Custom themes | The 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:
| Section | What it sets |
|---|---|
| Page | Background, 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. |
| Text | The typefaces for headings and page text, the page text size, and the heading, page text, and secondary text colors. |
| Card | The card that charts and filters sit in: Background, Border, Border width, Radius, Padding, Opacity, and Shadow. |
| Charts | Series 1 to 5, the colors a chart's series take in order. Also Typeface, Gridlines, Axis text, Data labels, Legend & titles, and Icons. |
| Table | Charts 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-lightanddefault-dark.
See Embed options.
Common problems
| What you see | What to check |
|---|---|
| A built-in theme has no edit button | Built-in themes cannot be changed. Duplicate one and edit the copy. |
| A dashboard's look changed though you did not touch it | Another author changed the custom theme it wears. Themes are shared across the install. |
| Some elements ignore the theme | They were styled by hand. Switch theme again and choose "Switch and reset to" the theme. |