> For the complete documentation index, see [llms.txt](https://docs.struct.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.struct.com/tutorials/guides/how-to-use-saved-searches/how-to-use-saved-searches-on-dashboards.md).

# How to use Saved Searches on Dashboards

Learn how to use Saved Searches on Dashboards to quickly access search results and monitor product activity through Dashboard widgets.

Saved Searches can be added to Dashboards using different widget types, allowing you to access important search results and monitor product activity directly from your workspace.

This tutorial explains how to add and configure Saved Searches using the Search Result and Timeline widgets, including how to customize the widgets to fit your preferred Dashboard layout.

## Add a Saved Search to a Dashboard

Saved Searches can be added to a Dashboard using either a Search Result widget or a Timeline widget.

## Search Result widget

The Search Result widget displays the results of a Saved Search directly on your Dashboard, giving you quick access to frequently used searches and product information.

### Add a Search Result widget

Open your Dashboard and click Edit Dashboard in the bottom-right corner.
  Click Add widget, or right-click anywhere on the Dashboard and select Add widget.
 Select Search Result from the widget list.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FJgzx4v8uGRTMEGEH9tdf%2FSearchResult.png?alt=media&amp;token=92d5a6e7-e569-4dae-9008-4106e5d65898" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Only Shared Saved Searches can be used on Shared Dashboards. If you are adding a Search Result widget to a Shared Dashboard, make sure the Saved Search was created under Shared Saved Searches.
{% endhint %}

### Configure the Search Result widget&#xD;<br>

After selecting the Search Result widget, choose the Saved Search you want to display.

You can customize the widget by:

* Setting a headline.
* Choosing which columns to display.
* Selecting an icon.
* Choosing highlight color.

Click Add widget when you are finished.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FYqUVYLpZrCMclZ8Qce5E%2FSearchResultConfig.png?alt=media&amp;token=c6a9b366-43e0-4983-8978-18a04237e957" alt=""><figcaption></figcaption></figure>

## Timeline widget

The Timeline widget allows you to monitor recent activity and changes related to products matching a Saved Search directly from your Dashboard.

### Enable a Saved Search for the Timeline widget&#xD;

Before adding a Timeline widget, you must enable the Saved Search you want to use.

Open the Saved Searches menu from the top-right corner of the navigation bar.
&#x20;Right-click the Saved Search you want to use.
&#x20;Select Enable for Timeline widget.
&#x20;The Saved Search is now available when configuring a Timeline widget.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FmPSZCFsEfFPB8Vnzo6BW%2FEnableTimeline.png?alt=media&amp;token=81506883-5077-4542-a581-67be5abca025" alt=""><figcaption></figcaption></figure>

### Add a Timeline widget&#xD;

Open your Dashboard and click Edit Dashboard.
&#x20;Click Add widget.
&#x20;Select Timeline from the widget list.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2F4aavPfnGe0yRYmayqJJx%2FTimeline.png?alt=media&amp;token=52c6539e-e107-4534-aa31-561fd8527d08" alt=""><figcaption></figcaption></figure>

### Configure the Timeline widget&#xD;

When configuring the widget, select the Saved Search you enabled previously.

You can customize the widget by:

* Setting a headline.
* Selecting a time unit (Days or Months).
* Choosing an icon.
* Chooseing a highlight color.

Click Add widget when you are finished.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FGd6xAjDhPCA4oXelmlth%2FTimelineConfig.png?alt=media&amp;token=bfad10d8-88a9-40ec-a472-ded66d89284e" alt=""><figcaption></figcaption></figure>

## Save and use the Dashboard

After adding either widget type:

Position and resize the widget as needed. Click Save Dashboard to save your changes.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FuBe5szGyNjyw1iCfCKqd%2FSk%C3%A6rmbillede%202026-08-10%20104053.png?alt=media&amp;token=0d22fc93-2f9b-430a-885b-8c3ffaa2dff5" alt=""><figcaption></figcaption></figure>

The widget will now display information from the selected Saved Search directly on your Dashboard.

The Search Result widget opens the Saved Search in the PIM when clicked, allowing you to continue working with the results or apply additional filters.

The Timeline widget displays recent activities and changes related to the Saved Search, making it easier to monitor updates without leaving the Dashboard.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.struct.com/tutorials/guides/how-to-use-saved-searches/how-to-use-saved-searches-on-dashboards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.