Adding rich text and filter snippets to dashboards
Who is this article for?
Users with permissions to create, edit, and manage dashboards, rich text snippets, and filter snippets in Insights.
Creator access, or READ and WRITE permissions for existing dashboards, along with access to dashboards containing visuals and snippets in Insights.
When you create or edit a dashboard, you can add rich text snippets to provide context to the visuals for your users, either by authoring your own content or by having Insights generate visual descriptions automatically.
Understanding rich text snippets
You can fully author your own rich text snippet or have Insights generate a visual description and add it to your dashboard in a rich text snippet.
When you create a rich text snippet, it is linked to the dashboard you've added it to. If you delete a dashboard, the snippet is deleted as well.
Creating a new rich text snippet
To create a new rich text snippet:
- Create or edit a dashboard.
- To add a snippet to an existing dashboard, log in as a user with READ and WRITE permissions for the dashboard. If you are creating a new dashboard, log in as a user with Creator access.
- Select T+ on the dashboard icon bar. A new rich text snippet is added in a widget on the dashboard, ready to edit.
- Add text or other information in the snippet, using the snippet format tools to adjust the look and layout of your text, or add images and links. As you add and update your text, use the undo and redo icons or keyboard shortcuts to undo and redo text changes.
- When you've added the information you need, select the edit pencil to hide the format tools and put the snippet in view mode.
- Save the dashboard.
Generating and inserting a rich text snippet with a visual description
To generate and insert a rich text snippet with a visual description:
- Create or edit a dashboard with one or more visuals.
- Ensure you have Creator permissions.
- Select the visual drop-down menu and choose Describe Visual > Create Snippet and Insert. A new rich text snippet is added in a widget on the dashboard with the text of the visual description, ready to edit.
- Add more text or other information in the snippet, using the snippet format tools to adjust the look and layout of your text, or add images and links. As you add and update your text, use the undo and redo icons or keyboard shortcuts to undo and redo text changes.
- When you've added the information you need, select the edit icon to hide the format tools and put the snippet in view mode.
- Save the dashboard.
Note: You can optionally select Describe Visual > Copy Visual Summary. This copies the summary to your clipboard. You can add it to an existing rich text snippet or use it outside of the Insights environment as needed.
Connecting visuals to a filter snippet
Build and use filter snippets to filter and highlight data on your dashboard. To apply filters to visuals, connect a filter snippet to one or more visuals using a corresponding field from the visual's underlying source. You can also filter a snippet by another snippet.
To connect visuals:
- Select the snippet on the dashboard. A blue border appears around the snippet widget.
- Select Connect Widgets from the menu. The Connect Widgets work area opens.
- Select Add Widget.
- Select a Widget Name and an available Field. Repeat to add as many visuals as desired.
- Select Apply to connect the visuals.
When you create a filter snippet, it is linked to the dashboard you've added it to. If you delete a dashboard, the snippet is deleted as well.
Note: To link filter snippets for further data refinement, see Link Filter Snippets.