Skip to main content

Build dashboards

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.

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.

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:

LevelThe app saysWhat it means for your viewers
VisibleYour customers can open this dashboard.Customers with access can open it.
CustomizableYour customers can open it and make their own copy.For your viewers, the same as Visible.
NoneHidden 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.

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.

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.

Saved versions​

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

ActionWhat it does
RenameGives the version a name you will recognize.
PinKeeps the version when GOAT removes the oldest versions to make room.
DeleteRemoves the version for good. The current version cannot be deleted.
RestorePrepares 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 seeWhat to check
Edit says "Unpublish to edit"The dashboard is Live. Unpublish it, edit, and publish again.
Copy is grayed outThe 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 offEmbedded 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 publishChanges reach viewers within about a minute.

Next​

GOAT documentation

Type to search.