# Dashboards

P4W dashboards contain the visual portion of the reporting widgets. This provides a quick and easy access to the warehouse key performance indicators (KPIs). Administrative users can add and configure dashboards in accordance with business needs. 

To create or access existing dashboards, navigate to Setup > Reporting > Dashboards. 

<figure><img src="/files/mrRvmxMFy0LuPvuVjPza" alt=""><figcaption></figcaption></figure>

## Create New Dashboard

To create new dashboard, click 'New' button in the top right corner of the page.&#x20;

<figure><img src="/files/GiidiINZXDK0lrWIqEOX" alt=""><figcaption></figcaption></figure>

In the 'New dashboard' pop-up window enter name and description. Click 'Submit' to continue.

<figure><img src="/files/sJeaU4570R2a6kyESVgC" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Notice: 'Name' is a mandatory field for filling.
{% endhint %}

### Add Widgets

To configure new dash board click name link to open dashboard details page as sown below.

<figure><img src="/files/Xe5Vutop71bg9HdA76Zk" alt=""><figcaption></figcaption></figure>

To add widgets to the current dashboard click 'Add widget' button in the top right corner of the page.

<figure><img src="/files/ZRAwKS6Y16wXOtxAJgYJ" alt=""><figcaption></figcaption></figure>

From the pop-up 'Widgets' widow, select every report you wish to see on the current dashboard. Make your selection by clicking 'Choose' button next to the desired position.

<figure><img src="/files/ZGNH8Zu9worH84bbVKbs" alt=""><figcaption></figcaption></figure>

### Rearrange Widgets

Dashboards are fully customizable and can contain one or multiple widgets at the same time. Users can rearrange widgets by using mouse left click and drag. To resize the widget visual, use direction arrows as shown below.

<figure><img src="/files/rPb9x6zodbFIYpEyiqZE" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Notice: Click 'Save' to implement dashboard settings. Changes do no save automatically.
{% endhint %}

## Widget Controls

Widget visual representation might have controls depending on how it is setup. &#x20;

Use direction buttons to switch between views. &#x20;

<figure><img src="/files/1VVcHKXRmljQwGYKEUJ2" alt=""><figcaption></figcaption></figure>

Widget refresh and delete buttons.

<figure><img src="/files/lKzVG79UWXWWWuDySU5B" alt=""><figcaption></figcaption></figure>

Some widgets might have variable values, like warehouse number, top # to display, etc. Use the cogwheel button to manipulate widget visual output.

<figure><img src="/files/OFi9rmIEv0d2PbohyuTS" alt=""><figcaption></figcaption></figure>

#### Presentation Options

Widgets have two tabs in the 'Presentation Options' window: 'General' and 'Filters'.

General tab is the same for every widget. Here users can add or edit name and description as well as add automatic refresh interval for the data output.

<figure><img src="/files/xTd1jlXnkJHW0lN9vd2N" alt=""><figcaption></figcaption></figure>

Presentation filters will vary depending on the widget settings (i.e. top #, product category, warehouse number, etc.).

<figure><img src="/files/bdSiLqTYfSlAobZpImlL" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Notice: click 'Submit' to apply changes.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.p4warehouse.com/v2/reporting/dashboards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.