Skip to content

docs(dashboards): list the widgets that need a feature, license or permission - #16879

Merged
blakeaowens merged 2 commits into
devfrom
docs/dashboard-widget-gates
Nov 14, 2026
Merged

blakeaowens merged 2 commits into
devfrom
docs/dashboard-widget-gates

Conversation

@blakeaowens

Copy link
Copy Markdown
Contributor

Description

Documents which Customizable Dashboards widgets need another feature, a license capability or a permission, and what happens when one is missing.

  • Custom Dashboards (PRO__custom_dashboards.md): a new "Widgets that need a feature, license or permission" table (Scan Cadence, License Usage, Ingest Health, Saved Reports, Top Root Causes, PCI Quarter Status, Onboarding, Sensor Coverage, the four PSIRT widgets, Ingestion Health Status, Shadow AI, AI Footprint, CRA Article 14 Deadlines). Add Widget offers such a widget only when everything it needs is in place, and a placed widget whose requirement goes missing shows a placeholder naming it and loads nothing. Regulatory Scope needs no feature, and the page says why. The Saved Reports row adds the generated-reports permission.
  • Dashboards API (PRO__custom_dashboards_api.md): the catalog's requires object (feature_flags, licensed_features, permissions), and that a widget_data action answers 403 while a requirement is missing instead of an empty result. Sensor Coverage is the one exception: it is listed only while Shogun is on and licensed, and while Shogun is off its action answers 404.

English only; the language copies are translated automatically.

Paired with the DefectDojo Pro change that ships this behavior; merge the two together.

…rmission

Adds a table of the Customizable Dashboards widgets that need another feature,
a license capability or a permission, and what the picker and a placed tile do
when one is missing. The API guide describes the catalog's requires object and
that a widget_data action answers 403 while a requirement is missing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0143hYTGjwQXD5FR5mbSdBxd
@blakeaowens blakeaowens added this to the 3.5.200 milestone Nov 14, 2026
@github-actions github-actions Bot added the docs label Nov 14, 2026
"Every built-in role grants it" read as if every user gets Saved Reports. The
permission comes from a global role or an Organization role (directly or through
a group); a role on an Asset alone does not grant it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0143hYTGjwQXD5FR5mbSdBxd
@blakeaowens
blakeaowens added this pull request to the merge queue Nov 14, 2026
Merged via the queue into dev with commit d8d7873 Nov 14, 2026
32 checks passed
@blakeaowens
blakeaowens deleted the docs/dashboard-widget-gates branch November 14, 2026 05:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants