Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,7 @@
"guides/custom-tooltip",
"guides/version-history",
"guides/how-to-promote-content",
"guides/verified-content",
"guides/keyboard-shortcuts",
"guides/table-calculations",
{
Expand Down
61 changes: 61 additions & 0 deletions guides/verified-content.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: "Verified charts and dashboards"
sidebarTitle: Verified content
description: Mark charts and dashboards as verified so your team can instantly identify trusted, approved content. Verified content gets a green checkmark badge that shows who verified it and when, and verification is automatically removed if the content is edited.
---

<Frame>
<img src="/images/guides/verified-content/dashboard-badge.jpeg" alt="Verified dashboard with green checkmark badge showing 'Verified by tori whaley'"/>
</Frame>

Verified charts and dashboards let organization and project admins sign off on specific content so the rest of your team knows at a glance which charts and dashboards are trusted and approved.

Each verified item gets a green checkmark badge that shows who verified it and when. Verification always reflects the current state of the content. If a chart or dashboard is edited after being verified, the badge is automatically removed and an admin will need to re-verify the updated version.

<Frame>
<iframe width="100%" height="420" src="https://www.loom.com/embed/2d2b4d46f10d498389c2061715708e54" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen />
</Frame>

## Who can verify content

Only organization admins and project admins can verify or unverify charts and dashboards. All other users can see which content is verified, but cannot change verification status themselves.

## Verifying a chart or dashboard

Admins can verify content directly from the chart or dashboard, or from the verification panel in project settings.

Admins also have a dedicated verification panel under **Project settings** that lists all verified content and provides a central place to manage verification across the project.

<Frame>
<img src="/images/guides/verified-content/admin-panel.png" alt="Verified content panel in project settings showing a list of verified charts and dashboards with their space and verifier"/>
</Frame>

## Where users see verified content

Once a chart or dashboard is verified, the green checkmark badge appears wherever that content is surfaced, including:

- The homepage, so users can quickly spot approved content to start from
- Chart and dashboard listings
- Inside the chart or dashboard itself, along with the verifier's name and verification timestamp

This makes it easy for teams to distinguish between exploratory or work-in-progress content and content that's been reviewed and approved.

<Frame>
<img src="/images/guides/verified-content/homepage-tab.png" alt="Homepage with a 'Verified' tab listing all verified charts and dashboards for quick access"/>
</Frame>

## Verification is automatically removed when content changes

Verification is tied to the exact state of the content at the time it was verified. If anyone edits a verified chart or dashboard, the verification badge is automatically removed. An admin will need to review the updated version and re-verify it.

This guarantees that a verified badge always reflects content that an admin has explicitly approved in its current form.

## Verification in charts and dashboards as code

Verification status is included in [charts and dashboards as code](/guides/developer/dashboards-as-code). When you run `lightdash download`, verified content includes verification metadata right in the YAML, so you can see which downloaded files represent approved content.

This is especially useful when you're using an AI agent, the [Lightdash CLI](/references/lightdash-cli), or [agent skills](/guides/developer/agent-skills) to build on top of trusted content. You can point your agent at your verified charts and dashboards as a source of truth for approved patterns, metrics, and layouts.

<Tip>
If you're building content with AI agents, starting from verified charts and dashboards is a great way to make sure new content is grounded in patterns your team has already reviewed and approved.
</Tip>
Binary file added images/guides/verified-content/admin-panel.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/guides/verified-content/homepage-tab.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading