Skip to content

Configuration

Everything the module configures lives under /admin/config/content/ai-disclosure, on five tabs, all behind the administer ai disclosure permission:

Tab Path What it holds
Policy /admin/config/content/ai-disclosure what the site declares: the disclosure policy and the editorial statement URL
Output /output how it declares it: the default icon variant, and the JSON-LD and meta tag switches
Fields /fields the fieldable bundles, and the one-step add and remove of the field
Grades /grades the nine shipped grades
Profiles /profiles the reusable disclosure profiles

The compliance report is not part of this section: it is a view under Reports, at /admin/reports/ai-disclosure, behind its own access ai disclosure report permission. Neither is the suggestions listing, at /admin/reports/ai-disclosure-suggestions, behind its own access ai disclosure suggestions permission.

Permissions

Permission Grants
administer ai disclosure the five configuration tabs. Restricted: it changes what the site legally declares.
access ai disclosure report the compliance report, and its CSV export where ai_disclosure_csv_export is enabled
access ai disclosure suggestions the suggestions listing, including notes recorded by third-party modules. Restricted: it is the only surface that shows a suggestion's raw note.
set ai disclosures on content editing the ai_disclosure field on content the user can already edit

The Policy tab

The Policy tab

Three settings:

  • Site disclosure policy. "Label only where required" shows the disclosure only where the grade requires a label. "Always disclose AI involvement" shows every disclosure, voluntary ones included. Displays set to "Follow the site policy" read this value. See What the reader sees for the exact rules.
  • Disclosure notice. The line shown to the reader when a disclosure carries a label. It is translatable, and leaving it empty renders no such line, as does clearing the legal line on the grade.
  • Editorial statement URL. Where the reader finds the site's editorial policy on AI-assisted content. It accepts an external URL, an internal path such as /about-ai, or a reference to a piece of content, and the reader-facing disclosure links to it when set. An internal path takes the page's language prefix when rendered, so a multilingual site can send each reader to their own language. That holds for a path the site actually routes: one that matches nothing is rendered as typed, without a prefix. The setting is translatable, for statement pages that are not translations of one another.

The Output tab

The Output tab

  • Default icon variant. Black, White, Black transparent or White transparent. This is the site-wide default. A display can override it per field, and the Automatic display variant keeps the transparency chosen here while picking light or dark from the reader's color scheme. Beside the list sits a preview of the chosen variant on a light and on a dark background, which is where a white icon shows itself as invisible against light. The same preview is on the field display's own icon variant setting.
  • Machine-readable output. Two checkboxes, both on by default: the schema.org JSON-LD block and the ai-disclosure meta tag. See What machines see.