Metabase tries to keep the default home page simple, as well as give admins the tools they need to customize the home page to suit their needs.
Admins can customize the home page by:
- Removing x-ray suggestions
- Pinning a dashboard
- Changing user permissions
- Hiding the data section
- Changing the landing page
In this article, we’ll transform the home page from fig. 1 into fig. 2.
Remove X-ray suggestions
There are three ways to remove X-ray suggestions from the home page:
We recommend you pin a dashboard because that method is easily reversible, keeps X-rays accessible when browsing data, and further personalizes the home page.
Hide X-ray section
Hiding the X-ray section removes X-rays from the home page without making any other changes.
Admins can hide X-rays by clicking the gray X that appears when you hover over any portion of the X-ray section (Fig. 3).
To restore the X-ray section, you’ll need to change your environment variables. For example, you can apply the change to a Metabase instance by starting up your instance with:
java -DMB_SHOW_HOMEPAGE_XRAYS="true" -jar metabase.jar
Toggle off X-rays
Toggling off the X-ray feature removes X-rays from the home page, but also turns off X-ray suggestions everywhere else.
From the Metabase Admin section, go to the general settings, and toggle off X-ray features (fig. 4).
Toggling off X-ray features prevents users from seeing X-ray suggestions and saving new X-rays.
You can toggle X-ray features back on whenever you want.
Pin a dashboard
Collections allow you to pin items like questions and dashboards to the header of a collection. To pin an item to the default home page, you simply pin the item in the Our analytics collection.
Pin a dashboard by following along with fig. 6 using our instructions. Note that users are only able to pin a dashboard to a collection when they have curate collection access to the Our analytics collection.
Go to the Our Analytics page by clicking the Browse all items button in the Our Analytics section of the homepage. On Our Analytics page, click on the Dashboards tab to view all your dashboards.
When you hover over a dashboard in the list, an ellipsis (…) will appear on the right side of the list item. Click the ellipsis and a dropdown menu will show you all your dashboard options (fig. 5).
Select the Pin this item (fig. 6), and the dashboard you’ve selected will move to the pinned section along the top of the Our Analytics page (which Metabase displays on the home page).
Admins can use this same method to pin questions as well!
Pinning items will replace the X-ray section on the home page with a section for your pinned items.
You can unpin an item at any time by going to Our Analytics. Hover over the item you want to unpin and click the blue pin that appears as you hover (fig. 7). If you unpin all items, your X-ray section will reappear on the home page.
Change user permissions
Changing a user’s data permissions and collection permissions can have a big impact on a user’s home page. Permissions affect which collections appear in the Our Analytics section of the home page, which databases appear in the Our data section, whether pinned items are visible, and even which buttons appear.
In our example, we’ll change our user’s collection permissions, so that they only have access to four of our collections.
Changing collection permissions and data permissions will not affect the way the home page looks for admin users, as admins always have permission to see all databases and collections. Non-admin users, by contrast, will only see the databases and collections they have access to.
Hide the Our Data section
To hide the Our Data section on the home page, hover over the Our Data section and a gray X will appear next to the section title. Click the gray X to remove the section from your home page.
Like the X-ray section, you can restore the Our Data to the home page by using environment variables. For example, when starting the metabase instance, you can restore the Our Data section to the home page by running:
java -DMB_SHOW_HOMEPAGE_DATA="true" -jar metabase.jar
Just keep in mind that each user’s data permissions will determine which databases users see in the Our Data section.
Changing the landing page
With Metabase Enterprise Edition, you have even more options, including customizing the look of your Metabase instance.
Enterprise lets you specify the landing page for your instance, which you can set to a dashboard, question, or X-ray.
Check out our article on how to brand your Metabase instance.