# Create a Dashboard Builder

{% hint style="warning" %}
You can only access Dashboard Builders in the Studio. It's a layout to be embedded in your software.
{% endhint %}

You can access to your Dashboard Builder in the Studio Toolbar, in the tab "**Dashboards**".

You will arrive on a table that list all of your app's dashboards.

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-1f634035da9e948d7a3489e2ab2a31c62c0101ce%2Fdashboard-list.png?alt=media" alt=""><figcaption><p>Dashboards list</p></figcaption></figure>

* You can now begin to build your dreamed dashboard.

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-d981f0656e0799fa87443949f143a7fb2d5d4255%2Fdashboard-empty.png?alt=media" alt=""><figcaption><p>Dashboard Builder - Empty</p></figcaption></figure>

* From the edition mode, you can select all tiles and stories that you have created in your App by clicking on **grey squares**. It will open a modal from where you can select your content.

### Select a tile

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-508b531f7098f9da004b03eb4400fc9647f43168%2Fdashboardselect-tile.png?alt=media" alt=""><figcaption><p>Dashboard Builder - Select a tile</p></figcaption></figure>

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-9d55f38e48bec1ad2c1481c709538313693e6126%2Fdashboard-tile-selected.png?alt=media" alt=""><figcaption><p>Dashboard Builder - Tile displayed</p></figcaption></figure>

### Select a story

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-872517fcdb50def1beb6a2a585b2b3f8827bb8ea%2Fdashboard-select-a-story.png?alt=media" alt=""><figcaption><p>Dashboard - Select a story</p></figcaption></figure>

{% hint style="info" %}
When a tile or a story, if an app filter is applied on it, it will be **automatically** inserted inside the Dashboard Builder.
{% endhint %}

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-bce18eb832632a574eca1f80fdc11749cfdb942d%2Fdashboard-builder-story-selected.png?alt=media" alt=""><figcaption><p>Dashboard Builder - Story displayed</p></figcaption></figure>

### Manage layout

You can easily resize or drag\&drop your content in your dashboard.

**Resize**

* Click on the bottom right "caret" icon to resize you content

**Drag & Drop**

* Hover a content, a "move" cursor will appear and you'll be able to grab and move you content elsewhere.

### Save your work

* When you're done, you can click on "Close edition".

{% hint style="info" %}
If you select content that is not yet published, you'll be prompt to publish your whole application.
{% endhint %}

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-8bda006011bb48348dbba268e97448a7d0f411f8%2Fdashboard-builder-view.png?alt=media" alt=""><figcaption></figcaption></figure>

### Edit title

* Hover the title and click on it
* Modify your title
* Tap "Enter" or click away from the title

{% hint style="success" %}
Your title is now updated!
{% endhint %}

### Filter management in the dashboard

Currently, it is not possible to create a filter at the dashboard level.

When a story is added to a dashboard, any associated filters are automatically included in the dashboard. The story’s filters are then visible in the header of the dashboard.

Once the story’s filters are integrated into the dashboard, it is not possible to modify these filters from the dashboard.

If a story is removed from the dashboard, the filters associated with the story will be removed from the dashboard.

{% @arcade/embed url="<https://app.arcade.software/share/3enzjJkXFl50vS9NNeXF>" flowId="3enzjJkXFl50vS9NNeXF" %}

###
