Lesson

Brand your Metabase

Use white label settings to change your Metabase's name, color palette, logo, favicon, and home page.

⚠️

White labeling

This feature is only available on Pro and Enterprise plans (both self-hosted and on Metabase Cloud).

You can customize how Metabase looks and feels with it’s white labeling settings.

White label settings

<em>Fig. 1</em>. Rebranded Metabase question.
Fig. 1. Rebranded Metabase question.

To start customizing Metabase’s appearance, click on the gear icon at the bottom of the navigation sidebar, select Admin settings > Settings and click on the White label tab.

Application name

Use the text box at the top of the white label settings to enter the name of your company. (We used “Data company” as an example.) Your company name will be saved and distributed throughout the application. Anywhere the text “Metabase” appeared will now be replaced by your company’s name.

<em>Fig. 2</em>. The white label settings page with the application renamed to Data company.
Fig. 2. The white label settings page with the application renamed to Data company.

Color palette

You can change the application’s default colors in the color palette section.

Click the color swatch you want to change. In the pop up, select a new color using your method of choice:

  • Drag the color selectors along the color and opacity gradients
  • Enter a hex number
  • Enter an RGBA number
  • Select a color swatch from the color palette provided
<em>Fig. 3</em>. Color palette settings.
Fig. 3. Color palette settings.

Logo and favicon

You can upload a company logo to replace the Metabase logo throughout the app. With an icon link, you can personalize the favicon that appears in your browser’s tab. Note that if you use a relative path, that path is not relative to the Metabase JAR, but to the webserver. So unless you are using a reverse-proxy, the path will be relative to the frontend resources available to the JAR.

<em>Fig. 4</em>. See the D for data company in the favicon on the tab.
Fig. 4. See the D for data company in the favicon on the tab.

If you change your application name, but not your favicon, the favicon will remain the Metabase logo, so make sure to set a favicon.

Home page

You can set the home page to open to a specific view: a collection, or dashboard, question, or data reference page. For example, if you want to set the homepage to the Browse data page (“http://localhost:3000/browse”), enter “/browse” in the home page field.

Sign-in page

Metabase will also reflect your changes on the sign-in page.

<em>Fig. 5</em>. Sign-in page with brand colors and logo applied for the Data company
Fig. 5. Sign-in page with brand colors and logo applied for the Data company

Further reading

Thanks for your feedback!

Get articles like this one in your inbox every month