---
title: "Installation"
manual: "Accessibility Quality Gate"
version: "main"
permalink: "https://docs.typo3.org/permalink/priebera/typo3-a11y-quality-gate:installation@main"
source: "Installation/Index.rst"
rendered: "2026-09-17T16:05:02+00:00"
---

# Installation {#installation-1}

## Requirements {#requirements}

| Requirement | Supported |
| --- | --- |
| TYPO3 | 13.4 LTS and 14.3 or later. TYPO3 14.0 to 14.2 are explicitly declared as conflicting and are not supported. |
| PHP | 8.2 or later (`"php": "^8.2"`) |
| Required TYPO3 system extensions | `typo3/cms-core`, `typo3/cms-backend`, `typo3/cms-frontend`, `typo3/cms-rte-ckeditor`, `typo3/cms-scheduler` |
| Third-party libraries | `mpdf/mpdf` (PDF export) |
| Optional PHP extension | `ext-sodium` — required for encrypted remote-access passwords and per-site AI provider keys |
| Outbound network access | Only for licensed features and Free Remote Preview (`https://api.priebera.sk`). The content scan and the rendered page check work without internet access. |

## Installation with Composer {#installation-with-composer}

Install the extension in a Composer-based TYPO3 installation:

```bash
composer require priebera/typo3-a11y-quality-gate
```

Then run the extension setup and flush the caches:

```bash
vendor/bin/typo3 extension:setup
vendor/bin/typo3 cache:flush
```

`extension:setup` creates the AQG database tables
(`tx_a11y_issue`, `tx_a11y_scan`, `tx_a11y_ruleset`,
`tx_a11y_field_config`, `tx_a11y_source_state`, the
`tx_a11y_remote_*` tables and `tx_a11y_ai_configuration`) and adds the
`tx_a11y_is_decorative` column to `sys_file_reference`.

See also
[Installing extensions](https://docs.typo3.org/m/typo3/tutorial-getting-started/14.3/en-us/Extensions/InstallingExtensions.html#installing-extensions).

## Installation in Classic mode {#installation-in-classic-mode}

In a Classic (non-Composer) installation, download the extension from the
[TYPO3 Extension Repository](https://extensions.typo3.org/extension/a11y_quality_gate)
and install it in the Extension Manager. Run the database analyser afterwards so
that the AQG tables are created.

> [!NOTE]
> In Classic mode the `mpdf/mpdf` library must be provided by the
> installation. PDF export is unavailable if the library cannot be loaded.

## First steps after installation {#first-steps-after-installation}

1.  Open the **Accessibility** backend module. On TYPO3 13 it is located below
    **Web**, on TYPO3 14 below **Content**. The backend route
    identifier stays `web_a11y` on both versions.
1.  AQG discovers the RTE and file fields it can analyse the first time the
    module opens or a scan runs, and writes them to
    `tx_a11y_field_config`. The overview confirms how many fields it
    registered. See [Scanned fields](https://docs.typo3.org/permalink/priebera/typo3-a11y-quality-gate:configuration-scan-fields@main).
1.  Review the discovered fields in **Settings** on the
    **Scan fields** tab. Newly discovered fields are enabled by
    default; disable the ones you do not want to check and press
    **Save changes**. Changes take effect only after saving.
1.  Optional: review the **Rules** tab and disable rules that do not
    apply to your project.
1.  Optional: configure the quality gate on the
    **Publishing rules** tab, see [Quality gate (publishing)](https://docs.typo3.org/permalink/priebera/typo3-a11y-quality-gate:configuration-quality-gate@main).
1.  Run a first scan, either with **Scan site** in the module or with
    the [CLI command](https://docs.typo3.org/permalink/priebera/typo3-a11y-quality-gate:automation-cli@main).
1.  Optional: activate a licence key, see [Licence activation](https://docs.typo3.org/permalink/priebera/typo3-a11y-quality-gate:configuration-licence@main).

## Backend user access {#backend-user-access}

The module is registered with `access: user`, so it is available to
administrators and to backend users whose groups have the module enabled. Grant
access to the module `web_a11y` in the backend user group configuration.

All AJAX routes used by the module inherit their access from the same module
identifier, so no additional permission configuration is required.

Editors additionally need edit permissions on the records they are asked to fix.
The image remediation actions (applying alternative text, marking an image as
decorative) additionally require the User TSconfig option described in
[User TSconfig](https://docs.typo3.org/permalink/priebera/typo3-a11y-quality-gate:configuration-tsconfig@main).