> For the complete documentation index, see [llms.txt](https://help.solink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.solink.com/docs/understand-your-business/widget-configuration/set-widget-filters.md).

# Set Widget Filters

Use widget filters to change displayed data on the Dashboard page.

{% tabs %}
{% tab title="Web" %}
You can set global widget filters across all your widgets to display data from a given time frame, date and/or a specific location.

Navigate to the top of the Dashboard page to select what filters to apply to your widgets:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-e7ed96e6da306889bcfd8a6abcbd42729601e0a0%2F7fe9fe60bfa9aa5c.png?alt=media" alt="" width="560">

1. **Date**: The date the widget data ends on.
2. **Time frame**: Choose to show widget data for a given day, week, month or year.
3. **Locations** : Select whether the widgets display data from all of your locations or one location.

### Pinned Widget Data

You can configure your widgets to override certain filters. For example, some widgets may display the same information regardless of whether you filter your widgets by Day, Week, Month or Year, or location.

If a widget displays the same information regardless of which filter you have the selected, it means the data in the widget is **pinned**. You can determine if data in a widget is pinned if there is a "pin" icon displayed at the bottom of the widget.

In the image below, the widget will always display data from a specific day regardless of filter. This is indicated by the "pin" icon:

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-80e994bbad48cf2cd54e27a8f57a11d6e89d8fc5%2F7e91fbf0e5bfb32d.jpg?alt=media)

In the second image below, the widget will always display data from All Locations regardless of filter. This is also indicated by the "pin" icon:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-4d71db0007c538dcbe027e712ffe13984699c611%2F74199732741d15ed.jpg?alt=media" alt="" width="560">

To remove a pin from a widget - so that when you apply a widget filter, the widget updates the data displayed in the widget:

1. Select widget **Settings**:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-bc5f931f88ebb55817f9ace579d25ab9c2e9bda2%2F124680453924ae8a.gif?alt=media" alt="" width="560">

2. Choose **Inherit** for the datapoint that you want to update when you set a widget filter (you can choose Inherit for Time frame and Locations):

![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-4d199d534e057dec601315b254a605d69f2b59ae%2Fd3dcc922f037adeb.png?alt=media)

3. Save the widget to apply the change.
   {% endtab %}

{% tab title="Mobile" %}
The Dashboard on the Solink mobile app is a **read-only view** of your Dashboard as it is configured on the web platform. The widgets on this page are the same as your Dashboard page in Solink.

By default, you can open the Dashboard page from the side menu:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-d6c996bec34eaace8cc99e6ee0a7af9323a11e3b%2F282c319c54b9e419.png?alt=media" alt="" width="360">

You can tap widget datapoints to reveal specific metrics for a widget:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-5f62f2269994d7bc916f85dd03e400ae11f5e7be%2F3f68f30e3fa93378.png?alt=media" alt="" width="560">

**Note**: Drill-down and widget creation + configuration are only available on the Solink web platform.

### Filter Dashboard

Use the filters at the top of the **Dashboard** page to filter by the following:

* **Location**: Filter displayed widgets to one or more locations. Tap to open the location picker.
* **Date**: Choose the reporting period. Use the **Day / Week / Month / Year** options to set the window, then use the **‹ ›** chevrons to step to the previous or next period.

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-f076acd8a161f858a10c504f018f08543f6386d4%2F68edea9a19d675af.png?alt=media" alt="" width="360">

You can also select and filter by a specific widget tag, located along the top of the page:

<img src="https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-35a89a4886dd519d9ed8b1e4f85fc7301dd15bc2%2F038dac83a30d4bb8.png?alt=media" alt="" width="360">

**Note**: Some widgets are locked to their own saved date range or locations. These show a small **pin** icon in the card footer and ignore the filters above.
{% endtab %}
{% endtabs %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.solink.com/docs/understand-your-business/widget-configuration/set-widget-filters.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
