Skip to main content
Dashboards allow you to arrange multiple charts that are related to each other into a single view. The process for creating dashboards is as follows:
  1. Create a new dashboard
  2. Add charts to your dashboard
  3. Add markdown or other content
  4. Save your dashboard
  5. Add filters to your dashboards
  6. Add tabs to your dashboard
  7. Share your dashboard

​
Create a new dashboard

On the nav bar, click “New” to create a new dashboard.
Fill out the details of your new dashboard and hit ‘Create’. Once done, you will be redirected to your new Dashboard page:
Next, you’ll want to add some tiles to your dashboard by clicking on the add tile button.

​
Add a chart to your dashboard

You can either create a new chart from within your dashboard, or you can add an existing chart.

​
Create a new chart

Creating charts from within a dashboard helps to keep your spaces and projects clutter-free from charts that are used only once in a dashboard. Charts that are created from within your dashboard are exclusive to the dashboard. This means that they can’t be reused in other dashboards in your project. Click “Add tile” and then “New chart” to create a chart that is exclusive to the dashboard. You will be taken to the chart builder. Once you save the chart it will appear at the bottom of your dashboard.
Note: These charts can’t be used in other dashboards and won’t be shown in the global search or in any space. If you want to make these charts reusable in other dashboards, you can detatch them from the dashboard and save them to a space so they’re permanent using the move to space option from the chart’s three-dot-menu.

​
Add an existing chart

You can add an existing chart to your dashboard by clicking “Add tile” and then “Saved chart”. Clicking any chart will add it at the bottom of your dashboard.
You can resize charts by dragging the lower-right corner. You can position your chart by dragging the center of the chart.

​
Add markdown or other content

In addition to charts, you can also add markdown tiles or embedded Loom videos to explain the dashboard to people who will be using it.

​
Markdown tiles

These tiles are very flexible and allow you to enter text with headers, formatting, etc. You can even include code blocks and images within markdown tiles. The built-in editor provides most formatting you’ll need.
You can paste IFRAME embed codes to embed things like Notion pages, CRMs, web analytics, etc. Anything that offers IFRAME embedding!
You can add images hosted on the web like your company logo. Just paste the image URL into the markdown tile using standard markdown image syntax: ![]() (example below) and it will be rendered as an image. 
![image alt text here](https://placehold-url.com/image.png)
You can add background colors to markdown tiles to emphasize sections or titles.
The image above can be achieved using this code: 
<div style="background-color:#8379F7;color:#ffffff;padding:32px 28px;border-radius:12px;text-align:center"> 
  <div style="font-size:48px">⚡</div> 
  <h2 style="font-weight:600;font-size:24px">Welcome to your Lightdash Dashboard</h2> 
</div>
There are a number of other inline HTML options available. Below are some examples - Copy and paste them into a markdown tile to check them out! 
Check out this <b>bold</b> word.
You can do <i>italics</i>.
And <u>underline</u>.
Or maybe you want to <s>strikethrough</s>.

Show code snippets like <code>Hello World!</code>.
Or <mark>highlight</mark> something important.

Add links like <a href="https://docs.lightdash.com/">this!</a>

Use <sub>subscript</sub> or <sup>superscript</sup>

<p style="color:red">Easily colour your text.</p>
<p style="font-size:20px">Or change the size.</p>
<p style="text-align:center">Center your text.</p>
<p style="text-align:right">Or align it to the right.</p>
<p style="text-align:justify">You can even justify a line of text if you are trying to communicate a point that is particularly long, perhaps something like this example sentence?</p>
<p style="word-spacing:5px">Change the word spacing. 👏</p>
<p style="font-style:italic;font-weight:bold;color:blue">
    Or combine a whole bunch of styles together.
</p>

<h1>It supports headings</h1>
<h2 style="color:red">Here's an H2 heading in red</h2>

You can include images and apply options and styles. Here's one I centered earlier:

<img src="https://placehold.co/300x200" alt="Centered Image" style="display:block;margin:0 auto" />

​
Loom tiles

All you need to do for embedding Loom videos is click on the Loom video option and enter a URL and title for the tile.

​
Save your dashboard

When you’re happy with the layout, hit “Save”. You can also see all of the saved dashboards in your project by clicking on Browse —> All Dashboards.

​
Add filters

Now let’s add some filters to your dashboard. First, start by editing your dashboard by clicking on the Edit dashboard button.
Click on the Add filter button to add a new filter to your dashboard by selecting a field and a value to filter by.
Select a value to filter by and hit Apply. You can add as many filters as you like.
Now that you’ve added a filter, you can see the filter applied to your dashboard.
Hit Save to save your dashboard with the new filter.

​
Leaving filters empty

You might want to add an empty-value filter so that your dashboard viewers can choose their own value and explore the data based on their own criteria. Your dashboard viewers might also want to add their own filters to your dashboard.

​
Adding an empty-value filter

Just edit your filter and ensure that you don’t provide a default value.

​
Marking a filter as required

You can mark a filter as required for the dashboard to run. This means that the dashboard will not run unless a value is selected for the filter. Just edit your filter and check the “Require value for dashboard to run” checkbox.
Until viewers have set a value for the filter, the dashboard will not run.
To learn more about adding filters to your dashboards, check out our guide on using filters.

​
Add tabs

As your dashboard grows you may find it supporting multiple teams and use cases. Lets add tabs to your dashboard for better organization!

​
Use tabs in these scenarios

  • Break up high level goals or themes, e.g. Revenue, Retention, Engagement
  • Separate views for different audiences, e.g. Executive Summary vs. Team-level detail
  • Avoid clutter and performance issues in dashboards with lots of tiles, e.g. split 30+ charts into three tabs based on priority or groupings like the first and second bullets above
While editing, click “Add tile” and then “Add tab”.
Give your new tab a unique name.
Once created, you can add content to your tab just like any other dashboard. You now have a new canvas to add content to your dashboard.

​
Editing and removing tabs

To edit a tab, click on the edit icon to the right of your tab name while in dashboard edit mode. You can either rename or remove the tab from your dashboard.
If you have content in a tab, you’ll have an option to safely remove that tab. This gives you an opportunity to transfer tab content to another tab.
From there, choose which tab you’d like to transfer the content. This way, you can keep your content while removing the actual tab.

​
Sharing tabs

You can share tab content just like you would a regular dashboard. Sharable links will navigate right to the tab that was active when you created the shareable link.

​
Embedding dashboard tabs

Embeddings with tabs work slightly differently. When embedding a dashboard with tabs, all the tabs will be appended to the dashboard. In this case, the embeddeding will be one dashboard with all content from all tabs.

​
Hide tile headers

You can hide the header of any tile on your dashboard to create a cleaner look or to give more space to the chart content.
  1. Enter edit mode by clicking the Edit dashboard button
  2. Click on the tile you want to modify and select Edit tile content
  3. Click the eye icon next to the tile title to hide it
The tile will now display without its header. To show the header again, repeat the same steps and click the eye icon to toggle visibility back on.

​
Share your dashboard

You might want to share your dashboard with other people in your organization. You can do this by copying the URL (or by pressing on the 🔗 button).