Public Widget
The Public Widget is an embeddable climate dashboard that lets you share your organization's climate progress with the public. It is designed for transparency — showing residents, stakeholders, and the public what your organization is doing about climate change.
The public widget is available to all organization types. It is especially valuable for municipalities that want to demonstrate progress to residents and council members.
What the Public Sees
When someone visits your public dashboard, they see:
- Organization name and climate action summary
- Total reduction percentage — progress toward your target
- Action counts — total actions, completed actions, and actions in progress
- Emissions trajectory chart — showing baseline, projected, actual, and target emissions over time
- On-track indicator — whether your organization is on track to meet its target
- Climate actions list — your public actions and their status (if enabled)
- Powered by scoped footer
The public dashboard does not require authentication — anyone with the link can view it.
Setting Up the Public Widget
Navigate to Actions → Public Dashboard (the Embed tab) to configure your widget.
Dashboard Status
Your public dashboard has three possible states:
| Status | Description |
|---|---|
| Draft | Dashboard is being configured but is not yet visible to anyone |
| Published | Dashboard is live and accessible via URL or embed |
| Paused | Dashboard was previously published but is temporarily hidden |
Visibility
| Option | Description |
|---|---|
| Public | Anyone with the URL can access the dashboard |
| Unlisted | The dashboard is accessible via direct link but is not indexed or listed publicly |
Data Policy
The data policy controls what information is shown on the public dashboard. You can independently toggle each of the following:
| Setting | What It Controls |
|---|---|
| Show actions | Display your public climate actions and their status |
| Show notes | Include notes and descriptions on actions |
| Show suppliers | Display supplier engagement information |
| Show evidence | Show links to supporting evidence documents |
Review your data policy carefully before publishing. Only enable settings that you are comfortable sharing publicly.
Embedding on Your Website
Once published, you can embed the dashboard on your own website in two ways:
Direct URL
Copy the public dashboard URL and link to it from your website. The URL follows the format:
https://app.scoped.earth/public/{your-org-slug}Iframe Embed
Copy the iframe snippet to embed the dashboard directly into any web page:
<iframe
src="https://app.scoped.earth/public/{your-org-slug}"
width="100%"
height="600"
frameborder="0"
></iframe>Allowed Origins
For security, you can specify which domains are allowed to embed your dashboard in an iframe. Add your website's domain(s) to the Allowed Origins list. If no origins are specified, the dashboard can be embedded on any domain.
Token-Based Access
scoped generates a unique token for your public dashboard. This token is included in embed URLs and provides an additional layer of access control. You can regenerate the token at any time if needed.
Locale and Theme
Customize the appearance and language of your public dashboard:
| Setting | Options |
|---|---|
| Locale | English or German |
| Theme | Light or dark mode |
The locale and theme settings apply only to the public-facing dashboard and do not affect your main scoped application.
Publishing Workflow
- Configure your data policy, visibility, allowed origins, and locale/theme
- Preview the dashboard to see how it will look to the public
- Publish — the dashboard goes live and the URL becomes active
- Embed the URL or iframe snippet on your website
You can pause the dashboard at any time to temporarily hide it without losing your configuration. Unpause to make it live again.
Versioned Snapshots
Each time you publish or update your public dashboard, scoped creates a versioned snapshot of your data. This means:
- The public always sees a consistent, point-in-time view of your data
- You control exactly when updates are pushed to the public
- Previous versions are preserved for audit purposes
Publishing a new snapshot does not happen automatically when you add data. You must explicitly publish an update for changes to appear on the public dashboard.
Next Steps
- Reduction Actions — Manage the actions that appear on your public dashboard
- Reporting & Exports — Generate formal compliance reports alongside your public dashboard
- Getting Started — Return to the setup guide