Dashboards

Product Analytics Dashboards are general-purpose dashboards built from the same explorations you create in the Explorer. Use them to monitor KPIs, document findings for stakeholders, or give a team a single place to track the metrics they care about.

​

Creating a Dashboard

1. Navigate to Product Analytics → Dashboards.
2. Click Create Dashboard in the top right.
3. Configure the dashboard’s settings (see below) and click Create.

Once created, you’ll be dropped into the dashboard editor where you can start adding blocks.

​

Dashboard Settings

When creating or editing a dashboard, you can configure:

• Name — A descriptive title for the dashboard.
• Projects — Limit the dashboard to one or more projects. Leave empty to make it available across all projects.
• Auto-update — When enabled, GrowthBook refreshes the dashboard’s data on a schedule (see Update Schedules).
• View access — Who can open the dashboard:
  • Organization members — Anyone in your organization can view it.
  • Only me / Owner only — Only the owner (and admins) can view it.
• Edit access — Who can modify the dashboard:
  • Any organization members with editing permission — Other users with dashboard edit permission can change the contents.
  • Only me / Owner only — Only the owner (and admins) can edit it.

When View access is set to private, Edit access is forced to private as well — you can’t have a dashboard nobody can see but other people can edit.

​

Update Schedules

When Auto-update is enabled, you can choose how often the dashboard refreshes:

• Stale-based — Refresh whenever the data is older than N hours. Defaults to 6 hours; can be set between 1 and 168 (one week).
• Cron — Refresh on a custom cron schedule. The minimum frequency is once per hour. The modal validates the cron string in real time and shows a human-readable description (e.g., 0 0 */2 * * → “at 12:00 AM, every 2 days”).

You can also refresh a dashboard manually at any time using the Update button on the dashboard view (see Refreshing a Dashboard).

​

The Dashboard Editor

Dashboards are built from a stack of blocks. Click Edit on a dashboard to open the editor. The editor has three areas:

• The block list on the left lets you reorder blocks via drag-and-drop. Hovering over a block reveals quick actions for editing, duplicating, and deleting.
• The dashboard canvas in the middle shows the live preview of the dashboard with all blocks rendered.
• The configuration sidebar on the right shows settings for the currently selected block (data source, chart type, dimensions, etc.).

Edits go into a draft state — none of your changes are persisted until you click Save. Use Cancel to discard the draft and return to the published version. The editor also keeps the rest of your in-flight work in memory, so you can switch blocks without losing changes.

​

Adding Blocks

Click Add Block at the bottom of the block list (or the + button between two existing blocks) and pick a type from the dropdown. The dropdown is grouped to make blocks easy to find.

​

Dashboard Blocks

The following block types are available on Product Analytics Dashboards. Each block has its own configuration sidebar with controls tailored to that block type.

​

Markdown blocks

Markdown blocks render standard Markdown — headings, lists, links, images, code blocks, and tables. Use them to:

• Title sections of the dashboard.
• Provide context, methodology, or caveats next to a chart.
• Embed images (such as wireframes or product screenshots).
• Link out to related Slack threads, Notion pages, or other documentation.

​

Explorer blocks

The Metric, Fact Table, and Data Source Explorer blocks share the same configuration UI as the standalone Explorer. The block sidebar shows:

• A condensed toolbar with Chart Type, Date Range, and (for time-series charts) Date Granularity.
• The full sidebar — data source, values, row filters, group-by dimensions, and Show As.

Each block runs its own query against the warehouse, so a single dashboard can mix data from multiple data sources or fact tables.

​

Custom SQL Query blocks

A Custom SQL Query block is bound to a saved query from Custom SQL Reports. The block can show:

• One or more visualizations attached to the saved query (Bar, Line, Area, Scatter, Big Value, or Pivot Table).
• The raw results table — useful when the value of the report is the data itself rather than a chart.

The order of items in the block matches the order configured on the saved query, and you can reuse the same saved query across multiple dashboards.

​

Saving an Exploration to a Dashboard

You can build a chart in the Explorer and add it to a dashboard in one step:

1. Configure the exploration in the Explorer.
2. Click Save to Dashboard in the top-right of the configuration sidebar.
3. Pick an existing dashboard or create a new one.

This saves the exploration as a Metric Explorer, Fact Table Explorer, or Data Source Explorer block on the destination dashboard. See Save to Dashboard for the full details on the modal.

​

Refreshing a Dashboard

Each dashboard has an Update button in the top right. When you click Update, GrowthBook re-runs every block’s query against the warehouse. While the refresh is in progress, you’ll see:

• A progress bar under the button showing how many of the queries have finished.
• A live status text — Updated 5m ago, One or more queries failed, or Update Failed — with a tooltip describing the error if one occurred.

If auto-update is enabled, a lightning icon appears next to the status, and the tooltip shows when the next automatic refresh will run.

​

Sharing and Collaboration

Once a dashboard is published to the organization, anyone with view access can:

• Open the dashboard.
• See the latest auto-refreshed data (or trigger a manual refresh).
• Click Share… to copy a direct link.

To control sharing on an existing dashboard, use the More menu (⋯) on the dashboards list and choose Share…. Only the owner and organization admins can change view and edit access.

​

Reassigning Ownership

Editing a dashboard you own (or that you administer) lets you change the Owner. Reassigning ownership is useful when a teammate leaves the company or hands a dashboard off to a different team.

​

Duplicating Dashboards

Use the Duplicate option in the More menu to create a copy of an existing dashboard. This is useful when you want to use one dashboard as a template for another (for example, copying a “Marketing KPIs” dashboard to start a “Growth KPIs” version). Duplicates inherit all blocks but are owned by the user who duplicated the dashboard.

​

Permissions

Dashboard actions are controlled by per-project permissions: Private dashboards (where edit access is set to Owner only) can only be edited and deleted by the owner and organization admins, regardless of other permissions. See User Permissions for the full set of dashboard-related permissions.

​

Best Practices

• Group by project — Scope dashboards to a project so the right people see them in the dashboards list and so they show up under the project filter.
• Lead with markdown — Use a Markdown block at the top of the dashboard to explain the dashboard’s purpose, the data sources it uses, and any caveats. Stakeholders shouldn’t have to guess what they’re looking at.
• Mix explorations and SQL — Cover the common cases with Metric and Fact Table explorers, and drop into Custom SQL Reports for the long-tail questions that don’t fit a structured explorer.
• Keep auto-update enabled — Pick a refresh cadence that matches your team’s data freshness needs (6 hours for daily standups, nightly cron for weekly reviews) so stakeholders always see fresh data when they open the dashboard.
• Reuse saved queries — A single saved SQL query can be referenced by many dashboards. Update the query once and every dashboard that links to it gets the new logic.