> ## Documentation Index
> Fetch the complete documentation index at: https://slatehq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Build and share a dashboard

> Describe a dashboard in plain words, review the draft Slate builds, save it, change it later, and share it with your team or with a public link.

Slate builds a dashboard from a short description. You review the draft, ask for changes in a chat, and save it when it looks right. Then you can share it inside your workspace or with anyone through a public link.

> [!NOTE]
>
> Dashboards are available to selected workspaces. Ask your Slate contact to turn them on for your workspace.

## Why It Matters

You don't need to know where the data lives or how to query it. Describe the question the dashboard should answer, and Slate finds the data and lays it out.

## Step 1: Describe the Dashboard

1. Click **Dashboards** in the Slate sidebar.
2. In the box at the top, describe what you want to see, for example `Weekly share of voice by AI platform for the last 90 days, compared with our two main competitors`.
3. Click **Generate**.

Under the box, **Suggested prompts** such as **AI visibility scorecard**, **Citations vs organic by page**, and **Keyword movers** fill the box for you. Edit the text, then click **Generate**.

Slate uses the last 30 days unless your description names another period.

## Step 2: Watch the Build

Slate opens the builder. The left side shows **Build progress**, the data sources it picked, and the conversation. The right side shows the **Live preview**.

* **Build progress** moves through **Reading the catalog**, **Probing sources**, and **Draft ready**. Its badge shows **Building**, **Ready**, or **Failed**.
* **Sources in this dashboard** lists each data source. A source marked **sample data** shows generated sample rows in the preview, not your data.
* If the badge shows **Waiting for your reply**, Slate asked a question in the conversation. Answer it to continue.

When the draft is ready, it appears in **Live preview**. Nobody else sees it until you save.

## Step 3: Ask for Changes

1. Type a change in **Ask for a change…**, for example `Add a table of the top 20 cited pages`.
2. Send it. Slate updates the draft, and the preview shows the result.
3. Repeat until the dashboard looks right.

You can't type while Slate is building. Each change makes a new draft, and your last saved version stays as it was. You can pick a model above the box. **Auto** is the default.

To rename the dashboard, click its title at the top and type a new one.

## Step 4: Save or Discard

* Click **Save** to keep the draft. Slate saves it as a new version and opens the dashboard. The first save is **v1**.
* Click **Discard** to leave without saving. A new dashboard that was never saved stays on the Dashboards page and shows **This dashboard has no built version yet**. Click **Open builder** there to start again.

If the build fails, the builder says so. Try a different description.

## Change a Saved Dashboard

Open the dashboard. People who can edit it see these buttons at the top.

### Ask for a change

1. Click **Ask for a change**. The builder opens with the dashboard's conversation.
2. Describe the change and review the new draft.
3. Click **Save** to make it the current version.

Use this to change data, queries, charts, or filters.

### Edit the layout yourself

1. Click **Edit**.
2. Drag and resize charts and tables. Click a card's **⋯** menu to **Duplicate** or **Remove** it, or click the pencil to rename it.
3. Optionally, set **Compaction** (**None**, **Vertical**, or **Horizontal**) and **Gap** to adjust the spacing.
4. Click **Save changes** to save a new version, or **Cancel edits** to drop your changes.

**Edit** changes only the layout and card titles. To change the data, use **Ask for a change**.

## Share in Your Workspace

1. Click **Share**. The **Share dashboard** dialog opens.
2. Under **Dashboard access**, choose **Workspace** or **Restricted**.
3. For **Restricted**, pick a person in **Choose a person to add…** and click **Add**. Set each person to **Can view** or **Can edit**, or click **Remove**.
4. Click **Save access**.

With **Workspace**, everyone in the workspace can open and change the dashboard. With **Restricted**, only you and the people listed can open it.

## Share a Public Link

A public link lets anyone open the dashboard without a Slate account. You need a saved version first: until then, the dialog says **Save the dashboard before creating a public link.**

1. Click **Share**, then turn on **Public link**.
2. Choose **Live (updates with data)** or **Snapshot (frozen)**. A live link runs the queries each time someone opens it. A snapshot keeps the data from the moment you create the link.
3. Choose when the link expires: **Expires in 7 days**, **Expires in 30 days** (default), **Expires in 90 days**, or **Never expires**.
4. For a live link, under **Viewers can change**, select the filters viewers may change. The other filters keep the values the dashboard shows right now.
5. Click **Create link**, then **Copy**.

> [!WARNING]
>
> Slate shows the full link only once, right after you create it. Copy it then. To get a new link later, click **Regenerate link**. The previous link stops working.

### What people see

People who open the link see the dashboard with "Viewing as guest", and only the filters you allowed. They can't see the data behind a chart or change the dashboard.

### Manage a link

* The link details show whether it's live or a snapshot, when it expires, how many times it was opened, and when it was last opened.
* A link always shows the version that was saved when you created it. After you save changes, change a setting and click **Replace link** to share the current version. This creates a new link and stops the old one.
* **Revoke link** stops a link at once. You can't turn a revoked link back on, but you can create a new one.
* Turning off **Public link** revokes every link for the dashboard.

An expired or revoked link shows **Link not found**.

## Credits

Each build and each change you ask Slate to make uses credits, like other agent work. Saving, editing the layout with **Edit**, and sharing don't use credits.

## Tips

* Name the question the dashboard answers and the period, such as "this month vs last month."
* Ask for one change at a time. It's easier to check the preview.
* Prefer a **Live** link for a dashboard people check often, and a **Snapshot** for a report you send once.

## What's Next

* [Dashboards](https://slatehq.com/docs/dashboards/overview.md): find, star, filter, and manage your dashboards
* [Billing and usage](https://slatehq.com/docs/settings/billing-and-usage.md): see your credit balance


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.