Rules Reference

The Accessibility Quality Gate extension provides editor-facing backend rules and rendered HTML checks designed to help identify common WCAG-related accessibility issues directly inside TYPO3. These rules are split into Rich Text Editor checks, structured TYPO3 content validation rules, and rendered HTML rules for the free page scan.

edit_noteRTE Rules

Context: RTE / CKEditor fields
Rule IDSeverityWCAG CriterionDescription
rte.img_alt_missingCritical1.1.1 Non-text ContentDetects images without an alt attribute or valid decorative handling.
rte.img_alt_is_filenameWarning1.1.1 Non-text ContentFlags alt texts that look like filenames instead of useful editor-facing descriptions.
rte.empty_headingCritical1.3.1 Info and RelationshipsPrevents empty heading tags inside rich text content.
rte.empty_linkCritical2.4.4 / 4.1.2Flags anchor tags without discernible text content or accessible name.
rte.button_label_missingCritical4.1.2 Name, Role, ValueChecks editor-created button-like elements for missing visible or accessible labels.
rte.table_missing_headerWarning1.3.1 Info and RelationshipsWarns when data tables do not contain header cells.
rte.table_th_missing_scopeWarning1.3.1 (H63)Checks table header cells for missing scope attributes.
rte.table_missing_captionInfo1.3.1 (H39) / Best PracticeSuggests captions for complex editorial tables.
rte.duplicate_idWarning1.3.1 Info and RelationshipsDetects duplicate id attributes inside the same rich text fragment.
rte.svg_missing_titleWarning1.1.1 Non-text ContentChecks inline SVG elements for missing title metadata.
rte.iframe_missing_titleCritical4.1.2 Name, Role, ValueRequires descriptive titles for embedded iframes.
rte.image_in_link_missing_altCritical1.1.1 / 2.4.4Ensures linked images still expose a meaningful accessible label.
rte.marquee_or_blinkCritical2.2.2 Pause, Stop, HideBlocks blinking or marquee-style content patterns.
rte.non_descriptive_linkWarning2.4.4 Link Purpose / Best PracticeWarns about vague link texts such as “click here” or “more”.
rte.heading_hierarchy_jumpWarning1.3.1 / 2.4.6Flags skipped heading levels in editorial content structure.
rte.link_new_window_no_warningWarning3.2.2 On InputWarns when links opening a new window do not tell the reader in advance.

account_treeStructured Rules

Context: tt_content / TCA
Rule IDSeverityWCAG CriterionDescription
structured.file_reference_altCritical1.1.1 Non-text ContentChecks image file references, falls back to metadata alt text, and supports decorative images with empty alt text.
structured.header_ctype_emptyWarning1.3.1 Info and RelationshipsWarns when structured content headers are enabled but left empty.
structured.header_link_no_textCritical2.4.4 / 4.1.2Detects linked headers without visible text content.
structured.uploads_file_missing_descriptionWarning2.4.4 Link PurposeRequests file descriptions for upload/download lists when the title alone is not enough.
structured.table_missing_captionInfo1.3.1 (H39) / Best PracticeSuggests captions for structured table content elements.

Rendered HTML Rules

Context: free page scan / live rendered HTML

Rendered page checks scan the current page HTML output from TYPO3. They are HTML-only, do not execute JavaScript and are available in the free version. Remote crawler checks are separate and use a browser-based scan in PRO/Agency/Trial.

RuleSeverityDescription
Missing image altCriticalFlags rendered images without a meaningful alt attribute.
Empty linkCriticalDetects links without visible text or an accessible name.
Empty buttonCriticalRequires a visible or accessible label for rendered buttons.
Missing form labelCriticalChecks form controls for missing associated labels.
Missing HTML langCriticalRequires a valid language on the root HTML document.
Duplicate IDsWarningWarns when duplicate id values appear in the rendered page.
Missing iframe titleWarningRequires descriptive titles for embedded iframes.
Empty headingWarningFlags heading elements that do not expose meaningful text.
Missing table headerWarningWarns when rendered data tables have no header cells.
Empty table headerWarningChecks table header cells for missing header text.
Missing page titleInfoDetects pages that do not expose a useful <title>.
Missing main landmarkInfoSuggests a clear main landmark for page structure and navigation.
SVG missing accessible nameInfoChecks inline SVG elements for a readable accessible name.