> For the complete documentation index, see [llms.txt](https://docs.onelens.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onelens.cloud/observe-visibility-and-insights/cost-reporting/dashboards/creating-a-dashboard.md).

# Creating a Dashboard

Custom dashboards allow you to create personalized views for monitoring cloud costs, AI usage, infrastructure metrics, and operational insights. Once created, dashboards can be populated with widgets from different OneLens modules and customized to suit your reporting needs.

***

### Create a New Dashboard

To create a new dashboard:

1. Navigate to **Dashboards** from the left navigation menu.
2. Click **Create Dashboard** (or create a new dashboard from the Dashboard listing page).
3. Enter a **Dashboard Name**.
4. Click **Create**.

A new dashboard is created with an empty canvas where you can begin adding widgets.

> **Note:** A newly created dashboard does not contain any widgets. Click **Add Widget** to start building your dashboard.

***

### Dashboard Toolbar

Once a dashboard is created, the toolbar provides quick access to common actions.

| Action                | Description                                             |
| --------------------- | ------------------------------------------------------- |
| **Add Widget**        | Add a new widget to the dashboard.                      |
| **Save Changes**      | Save the current dashboard layout and configuration.    |
| **Edit**              | Modify dashboard properties such as its name.           |
| **Manage Access**     | Share the dashboard with other users.                   |
| **Global Time Range** | Apply a common time range across compatible widgets.    |
| **Granularity**       | Change the aggregation interval for time-based widgets. |
| **Filters**           | Apply dashboard-wide filters to supported widgets.      |

***

### What to Do Next

After creating your dashboard, you can:

* Add widgets using the **Simple Widget Creator** or **Query Builder**
* Rearrange and resize widgets
* Apply dashboard-wide filters
* Configure access permissions
* Save your dashboard layout

***

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

> A newly created dashboard opens as an empty canvas. Use **Add Widget** to begin building your 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.onelens.cloud/observe-visibility-and-insights/cost-reporting/dashboards/creating-a-dashboard.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.