Defining custom dashboard error and empty results messages

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, JustAsk displays messages when a query encounters an error or doesn’t return results:

No results returned

Default state for a query with no results returned

Error

Default state for a query in an error state

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.

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:

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 like the following to add and style your message:

   Example of custom Markdown No results message

   <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:

   

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: