Skip to content

Commit 0a2f3f8

Browse files
torimwhaleyclaude
andauthored
docs: add verified charts and dashboards guide (#548)
* docs: add verified charts and dashboards guide Co-Authored-By: Claude Opus 4 (1M context) <noreply@anthropic.com> * docs: add screenshots to verified content guide Co-Authored-By: Claude Opus 4 (1M context) <noreply@anthropic.com> * docs: rename verified content screenshots to shorter names Co-Authored-By: Claude Opus 4 (1M context) <noreply@anthropic.com> * docs: remove em dashes from verified content guide Co-Authored-By: Claude Opus 4 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4 (1M context) <noreply@anthropic.com>
1 parent b74361d commit 0a2f3f8

File tree

5 files changed

+62
-0
lines changed

5 files changed

+62
-0
lines changed

docs.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,7 @@
9494
"guides/custom-tooltip",
9595
"guides/version-history",
9696
"guides/how-to-promote-content",
97+
"guides/verified-content",
9798
"guides/keyboard-shortcuts",
9899
"guides/table-calculations",
99100
{

guides/verified-content.mdx

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
---
2+
title: "Verified charts and dashboards"
3+
sidebarTitle: Verified content
4+
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.
5+
---
6+
7+
<Frame>
8+
<img src="/images/guides/verified-content/dashboard-badge.jpeg" alt="Verified dashboard with green checkmark badge showing 'Verified by tori whaley'"/>
9+
</Frame>
10+
11+
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.
12+
13+
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.
14+
15+
<Frame>
16+
<iframe width="100%" height="420" src="https://www.loom.com/embed/2d2b4d46f10d498389c2061715708e54" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen />
17+
</Frame>
18+
19+
## Who can verify content
20+
21+
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.
22+
23+
## Verifying a chart or dashboard
24+
25+
Admins can verify content directly from the chart or dashboard, or from the verification panel in project settings.
26+
27+
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.
28+
29+
<Frame>
30+
<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"/>
31+
</Frame>
32+
33+
## Where users see verified content
34+
35+
Once a chart or dashboard is verified, the green checkmark badge appears wherever that content is surfaced, including:
36+
37+
- The homepage, so users can quickly spot approved content to start from
38+
- Chart and dashboard listings
39+
- Inside the chart or dashboard itself, along with the verifier's name and verification timestamp
40+
41+
This makes it easy for teams to distinguish between exploratory or work-in-progress content and content that's been reviewed and approved.
42+
43+
<Frame>
44+
<img src="/images/guides/verified-content/homepage-tab.png" alt="Homepage with a 'Verified' tab listing all verified charts and dashboards for quick access"/>
45+
</Frame>
46+
47+
## Verification is automatically removed when content changes
48+
49+
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.
50+
51+
This guarantees that a verified badge always reflects content that an admin has explicitly approved in its current form.
52+
53+
## Verification in charts and dashboards as code
54+
55+
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.
56+
57+
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.
58+
59+
<Tip>
60+
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.
61+
</Tip>
386 KB
Loading
109 KB
Loading
353 KB
Loading

0 commit comments

Comments
 (0)