README

Accessibility Quality Gate is a TYPO3-native accessibility checker that brings CKEditor feedback, WCAG issue management, rendered page checks and publishing safeguards into the editorial workflow.

Product · Documentation · Pricing · Free Trial · Support · Packagist · TER

Install

composer require priebera/typo3-a11y-quality-gate
./vendor/bin/typo3 extension:setup

Supports TYPO3 13.4 LTS and TYPO3 14.3+.

Features

Free — no licence key required

• CKEditor 5 inline highlighting for accessibility issues
• Backend overview and page detail modules
• Issue tracking with ignore / unignore workflow and expiry dates
• Stable issue fingerprints across rescans
• Batch ignore workflow with required reason confirmation
• Per-rule enable / disable in Settings
• Manual local scans via backend module and CLI
• Automated local scans via TYPO3 Scheduler
• Changed-only scan mode for incremental rescans
• Quality gate warning mode on page publish / unhide; editors can continue after reviewing the warning
• FREE rendered page checks for manual Scan this page and Scan site actions, inspecting TYPO3 server-rendered HTML without executing JavaScript
• CSV export
• TCA-based field discovery for tt_content RTE and file fields
• Settings module for enabling and disabling scanned fields
• Built-in rules that help identify common WCAG-related accessibility issues in RTE content, structured fields and rendered HTML

Trial / PRO / Agency

• Remote browser accessibility scans via Playwright + axe-core
• Remote browser scan results with issue breakdown and screenshot preview
• Frontend scan history for site and single-page scans, including scan comparison and regression signals
• Recommended remediation plans with friendly rule metadata, affected user groups, WCAG references and suggested ownership
• Accessibility Statement Draft Assistant with English and German preview plus HTML, TXT and PDF exports
• WCAG 2.2 target-size reporting and expanded color-contrast remediation guidance
• PDF export for overview and page detail reports
• Remote CSV export
• Per-site quality gate configuration
• Quality gate blocking mode on publish / unhide
• Diff tracking for new and resolved issues across scans
• Multi-site support for agencies

Plan details, trial access and pricing:

• Trial: https://typo3.priebera.sk/trial
• Pricing: https://typo3.priebera.sk/pricing

Requirements

• TYPO3 13.4 LTS or TYPO3 14.3+
• PHP 8.2 or higher
• No additional services required for the Free version

Screenshots

Overview

Page detail

CKEditor inline highlighting

Links

Compatibility

Built-in rules

AQG includes rules across three categories. For the full reference with WCAG mappings and fix guidance see the documentation: https://typo3.priebera.sk/docs/rules

RTE rules — CKEditor and RTE HTML content

Structured rules — TCA field values

Some structured rules may adjust severity depending on the detected case, for example missing alternative text versus title-only fallback.

Rendered HTML rules — FREE, manual, server-rendered HTML only

Rendered checks run when an editor manually starts Scan this page or Scan site. They inspect the final server-rendered HTML returned by TYPO3 and do not execute JavaScript, AJAX or lazy-loaded browser interactions. Manual Scan site applies these checks to supported frontend pages in the selected site scope. CLI and Scheduler scans continue to use the Local scan workflow. Browser-based crawling, JavaScript execution and screenshots remain Trial / PRO / Agency features.

Installation and setup

composer require priebera/typo3-a11y-quality-gate

Then run TYPO3 extension setup and flush caches:

./vendor/bin/typo3 extension:setup
./vendor/bin/typo3 cache:flush

Next:

1. Open the Accessibility Quality Gate module in the TYPO3 backend
2. Run Re-scan TCA in Settings once
3. Configure a Scheduler task or run scans manually via backend module or CLI

For full setup and usage instructions see the documentation: https://typo3.priebera.sk/docs

Configuration

Field settings

In the Settings module you can:

• refresh supported fields from TCA
• enable or disable individual fields and rules
• control which fields are included in future scans

Changes are applied only after clicking Save settings.

Quality Gate

A default ruleset is created automatically on first use.

For site-specific rulesets set site_identifier to match the TYPO3 site configuration identifier.

CLI usage

# Scan a subtree
./vendor/bin/typo3 a11y:scan --root-pid=1

# Scan a single page
./vendor/bin/typo3 a11y:scan --page-uid=42

# Scan changed content only
./vendor/bin/typo3 a11y:scan --root-pid=1 --changed-only

# Scan a specific language
./vendor/bin/typo3 a11y:scan --root-pid=1 --language=1

CLI and Scheduler commands run the Local scan workflow. FREE rendered page checks are started manually from the backend through Scan this page or Scan site.

Backend User TSconfig

options.a11y_quality_gate {
    showToolbarItem = 1
    showScanAll = 1
    showScanNow = 1
}

Scope

AQG helps teams identify common accessibility issues early in the TYPO3 editorial workflow. It is not a legal certification tool and cannot guarantee WCAG, EAA, BITV or any other accessibility compliance on its own.

The Free rendered page check analyzes server-rendered HTML only. It does not execute JavaScript, wait for AJAX or lazy-loaded content, interact with cookie banners or take screenshots. Browser-based crawling, screenshots and axe-core checks are part of the Trial / PRO remote scanner.

Accessibility Quality Gate does not replace a full accessibility audit, keyboard testing, assistive technology testing or a professional WCAG review. Some rules reflect best practices and may not always correspond to a hard WCAG failure in every context. All findings should be reviewed in context.

License

GPL-2.0-or-later