> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Defining custom dashboard error and empty results messages

> Customize the messages that display on dashboards when queries encounter errors or don't return results.

Adding your own custom messages to dashboards allows you to not only apply your own branding, but to make the experience more friendly and intuitive for your users.

By default, Omni displays messages when a query encounters an error or doesn't return results:

<Columns cols={2}>
  <Card title="No results returned" img="https://mintcdn.com/omni-e7402367/XuuXPcRjgqJpBhLe/visualize-present/images/default-no-results-message-state.png?fit=max&auto=format&n=XuuXPcRjgqJpBhLe&q=85&s=492c6727a302b10059d4c1dd4156c26d" width="456" height="394" data-path="visualize-present/images/default-no-results-message-state.png">
    Default state for a query with no results returned
  </Card>

  <Card title="Error" img="https://mintcdn.com/omni-e7402367/XuuXPcRjgqJpBhLe/visualize-present/images/default-error-message-state.png?fit=max&auto=format&n=XuuXPcRjgqJpBhLe&q=85&s=cb38500f401b5774703fc7a544a8a158" width="462" height="394" data-path="visualize-present/images/default-error-message-state.png">
    Default state for a query in an error state
  </Card>
</Columns>

## Requirements

To follow the steps in this guide, you need **Editor** or **Manager** permissions on the document you want to modify.

## Steps

<Note>
  If a query has No Results and an Error state, No Results will take precedent with or without customization.
</Note>

1. Navigate to the dashboard you want to modify.

2. Click the **Edit** button in the upper right corner of the page to enter draft mode.

3. Click **Edit > Dashboard settings**.

4. Locate the **Custom messages** section:
   <img src="https://mintcdn.com/omni-e7402367/XuuXPcRjgqJpBhLe/visualize-present/images/custom-message-dashboard-settings.png?fit=max&auto=format&n=XuuXPcRjgqJpBhLe&q=85&s=8f99f22dc2193f0a36eb1b7e36ae8faf" alt="" width="278" height="600" data-path="visualize-present/images/custom-message-dashboard-settings.png" />

5. Click one of the message types to customize it.

6. Click the **Customize** toggle, which enables the Markdown editor. You can use [custom Markdown](/visualize-present/visualizations/types/markdown#using-the-markdown-editor) like the following to add and style your message:

   ```html wrap title="Example of custom Markdown No results message" theme={null}
   <style>
   div {
   display: flex;
   justify-content: center;
   align-items: center;
   }
   </style>
   <div>you don't have access to this data</div>
   <br>
   <div>![](https://github.com/RichardCzechowski/all-the-blobbies/blob/main/blobbies-slack/blobby-math.gif?raw=true)</div>
   ```

7. The preview of the message will update as you work. For example, this is the preview for the custom Markdown from the previous step:

   <img src="https://mintcdn.com/omni-e7402367/XuuXPcRjgqJpBhLe/visualize-present/images/custom-markdown-error-preview.png?fit=max&auto=format&n=XuuXPcRjgqJpBhLe&q=85&s=8148fce3d6a35dcc2aea531f61168cb8" alt="" width="403" height="824" data-path="visualize-present/images/custom-markdown-error-preview.png" />

8. When finished, click **Update** to save your changes.

Now when a query on this example dashboard doesn't return results, this custom message will display:

<img src="https://mintcdn.com/omni-e7402367/XuuXPcRjgqJpBhLe/visualize-present/images/custom-error-in-tile.png?fit=max&auto=format&n=XuuXPcRjgqJpBhLe&q=85&s=e208471d0013b11de412b819750c6c4a" alt="Custom message within a dashboard tile" width="1250" height="414" data-path="visualize-present/images/custom-error-in-tile.png" />
