> For the complete documentation index, see [llms.txt](https://knowledge.out-smart.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.out-smart.com/backoffice/backoffice/dashboards/add-and-customize-dashboard-widgets.md).

# Add and customize dashboard widgets

Widgets turn a dashboard into a useful overview.

Each widget can show different data and different filters.

### Add a widget

{% stepper %}
{% step %}

### Open the dashboard

Open the dashboard you want to edit.
{% endstep %}

{% step %}

### Open the widget list

Click the **+** button in the bottom-right corner.
{% endstep %}

{% step %}

### Choose a topic and widget

Select a topic first.

Then choose the widget you want to use.
{% endstep %}

{% step %}

### Place the widget

Drag the widget into the dashboard.
{% endstep %}
{% endstepper %}

### Arrange the layout

You can:

* drag widgets to a new position
* resize widgets by dragging the corners
* add the same widget more than once with different filters

### Customize a widget

{% stepper %}
{% step %}

### Open the widget options

Hover over the widget.

Then click the **<** button on the widget.
{% endstep %}

{% step %}

### Choose the action

Use **Save** to keep your changes.

Use **Settings** to configure the widget.

Use the **pencil** button to rename it.

Use the **bin** button to remove it.
{% endstep %}

{% step %}

### Set the widget criteria

Add the filters that decide what the widget shows.

The available criteria depend on the widget.
{% endstep %}

{% step %}

### Add rules or rule groups

Click **Add rule**.

Then build one condition or combine multiple conditions.
{% endstep %}
{% endstepper %}

### Example filters

Common examples include:

* work orders from the last 7 days
* records assigned to one employee
* only one status or category

### Frequently asked questions

<details>

<summary>Do all widgets support the same filters?</summary>

No.

The available criteria depend on the widget.

</details>

<details>

<summary>Can I rename a widget?</summary>

Yes.

Use the **pencil** button in the widget options.

</details>

<details>

<summary>Can I remove a widget later?</summary>

Yes.

Use the **bin** button in the widget options.

</details>

### Related topics

* [**Create an additional dashboard**](/backoffice/backoffice/dashboards/create-an-additional-dashboard.md)
* [**Control who can see a dashboard**](/backoffice/backoffice/dashboards/control-who-can-see-a-dashboard.md)
* [**What are Dashboards?**](/backoffice/backoffice/dashboards/what-are-dashboards.md)


---

# 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://knowledge.out-smart.com/backoffice/backoffice/dashboards/add-and-customize-dashboard-widgets.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.