# Publish and share

Publish a dashboard, choose which customers can see it, and get the snippet to embed it.

Publishing makes the current version of a dashboard available to embed. The Publish & share panel then sets which of your customers can open it. It also gives you the snippet your developers paste into your product.

## Before you start

The dashboard is built and checked. To see what one customer will see, pick a tenant in the Preview as menu in the builder's top bar. See [Build a dashboard](build-a-dashboard.md#check-it-then-publish).

## Open the panel

Open it from any of these places:

- In the builder, choose Publish in the top bar.
- On the dashboard's page, choose Publish & share.
- In the collection's Dashboards tab, choose Publish & share… from the dashboard's menu.

<!-- Screenshot: the Publish & share panel on a Live dashboard, all three steps visible; light and dark. -->

## 1. Publish

The step shows whether the dashboard is a Draft or Live. Once it is published, the step also shows its version number and who published it.

1. Optionally, type a Revision name. Left blank, it takes the dashboard's name and the time.
2. Choose Publish.

GOAT says "Dashboard published." If you published from the builder, it closes the builder and opens the dashboard's page. Choose Publish & share there for the next two steps.

If a chart is waiting for its dataset to finish loading, GOAT warns you first. Choose Wait, or Publish anyway. With Publish anyway, viewers see that chart loading until the data arrives.

## 2. Choose who can see it

Pick the dashboard's Tenant access:

| Level | The app says | What it means for your viewers |
|---|---|---|
| Visible | Your customers can open this dashboard. | Customers with access can open it. |
| Customizable | Your customers can open it and make their own copy. | For your viewers, the same as Visible. |
| None | Hidden from your customers. Nobody outside your team can open it. | No customer can open it. |

The level is one half of who can open the dashboard. The other half is a list of which customers may open it. The first time a dashboard is published at Visible or Customizable, GOAT puts every customer on that list.

A dashboard first published at None gets an empty list, and raising its level to Visible later does not fill it. The step then shows "Your customers can't see this dashboard yet." Choose Share with all customers to put every customer on the list.

To give one tenant access, or take it away, your developers use GOAT's API. See [Tenants and access](../embed/tenants-and-access.md#access-to-dashboards).

## 3. Put it on your site

A checklist shows whether the dashboard is ready to embed. It checks that the dashboard is published, and that your customers can open it. It also checks each dataset: one with no tenant key must be shared, which is set on the dataset's Tenancy tab.

Choose Copy to copy the snippet. Copy works only once the dashboard is published. Before that, the step says "Publish first. Until then this code shows nothing on your site." Notes for your developer, below the snippet, list what your developers change before it works. Send them the snippet and [Embed a dashboard](../embed/embed-a-dashboard.md).

## Change a published dashboard

A Live dashboard cannot be edited. To change it:

1. In the panel's first step, choose Unpublish. It happens at once, with no confirmation.
2. Edit the dashboard in the builder.
3. Publish it again.

While it is unpublished, your viewers cannot open it. An embedded dashboard shows "This dashboard is not available. It may have been removed, or you may not have access to it." Publishing again restores it. Access you gave stays in place while the dashboard is unpublished.

Publishing and unpublishing reach viewers within about a minute.

One change does reach a Live dashboard without a publish. It is an edit to a saved chart that the dashboard shares with another one. See [Create charts](create-charts.md#charts-are-shared).

## Saved versions

Each publish saves a version. Open Saved versions in the panel to see them, with the current one marked Current.

| Action | What it does |
|---|---|
| Rename | Gives the version a name you will recognize. |
| Pin | Keeps the version when GOAT removes the oldest versions to make room. |
| Delete | Removes the version for good. The current version cannot be deleted. |
| Restore | Prepares the version to be published again. See below. |

Restore does not change anything for viewers by itself. It stages the dashboard, its charts, and its filters as they were in that version, and lists what changed since. Then, under "Staged, awaiting publish", choose Publish to apply it, or Discard.

## Common problems

| What you see | What to check |
|---|---|
| Edit says "Unpublish to edit" | The dashboard is Live. Unpublish it, edit, and publish again. |
| Copy is grayed out | The dashboard is not published yet. |
| "Your customers can't see this dashboard yet." | No tenant has access. Choose Share with all customers. |
| The checklist says a dataset has no tenant key and its sharing is off | Embedded viewers get no data for that dataset's charts. On the dataset's Tenancy tab, set a tenant key or turn sharing on. |
| Viewers still see the old version a moment after you publish | Changes reach viewers within about a minute. |

## Next

- [Embed a dashboard](../embed/embed-a-dashboard.md), for your developers.
- [Tenants and access](../embed/tenants-and-access.md)
