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¶

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¶

- 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-disclosuremeta tag. See What machines see.