Alt-Text Checker

Extension key: alt_text_checker
Version: main
Language: en
Copyright: 2026-2026
Authors: Devs @ Leuchtfeuer Digital Marketing
Email: dev@Leuchtfeuer.com
License: This extension documentation is published under the CC BY-NC-SA 4.0 (Creative Commons) license.

Extension that adds a warning overlay icon in the File List module for files missing alternative text, and adds an Alternative text column to file reference tables in the backend.

TYPO3

The content of this document is related to TYPO3 CMS, a GNU/GPL CMS/Framework available from typo3.org.

Community Documentation

This documentation is community documentation for the TYPO3 extension {extension.name}

It is maintained as part of this third party extension.

If you find an error or something is missing, please: Report a Problem

Extension Manual

This documentation is for the TYPO3 extension Alt-Text Checker.

For Contributors

You are welcome to help improve this guide. Just click on "Edit on GitHub" on the top right to submit your change request.

Sitemap

For Administrators

Installation

There are several ways to require and install this extension. We recommend to get this extension via composer.

Via Composer

If your TYPO3 instance is running in composer mode, you can simply require the extension by running:

composer req leuchtfeuer/alt-text-checker

Via Extension Manager

Open the extension manager module of your TYPO3 instance and select "Get Extensions" in the select menu above the upload button. There you can search for alt-text-checker and simply install the extension. Please make sure you are using the latest version of the extension by updating the extension list before installing the Alt-Text Checker extension.

Via ZIP File

You need to download the locate extension from the TYPO3 Extension Repository and upload the zip file to the extension manager of your TYPO3 instance and activate the extension afterwards.

Enabling this Extension

Extension is activated by default after installation.

For Editors

Warning icon in the File List

The extension hooks into TYPO3's icon rendering via the PSR-14 ModifyIconForResourcePropertiesEvent. It adds an overlay-warning icon to any file in the File List module when:

the file itself has no alternative text set in sys_file_metadata, or
any of its file references has no alternative text set in sys_file_reference

This gives editors a quick visual cue to identify images that need attention before publishing.

"Alternative text" column in reference tables

The extension overrides the backend ElementInformation template to add an Alternative text column to the "References to this item" table. The column shows:

Value	Meaning
Yes	All file references for this relation have alternative text set
No	At least one file reference for this relation is missing alternative text

The column is visible when viewing the info panel of any file in the backend (click the info icon next to a file in the File List).

References table with Alternative text column

How to use

Open the File module in the TYPO3 backend.
Navigate to the folder containing your images.
Any image with a yellow warning overlay icon is missing alternative text — either at the file level or in one of its references.
Click the info icon (ℹ) next to a file to open the element information panel.
Scroll to the References section. The Alternative text column shows Yes or No for each relation.
To fix a missing alt text:
- At file level: Edit the file metadata and fill in the Alternative Text field (sys_file_metadata.alternative).
- At reference level: Edit the content element or record that references the file and fill in the Alternative Text field on the image relation.

Once all missing alt texts are filled in and the cache is cleared, the warning icon disappears.

Localization

The extension ships with English and German translations. To add your own language, create a translation file.

About

The users country and preferred language and other facts will be detected. Depending on configurable rules the user can be redirected to other languages or pages. It is also possible to deny access to configurable pages for configurable countries.

Compatibility

We are currently supporting following TYPO3 versions:

Extension Version	TYPO3 v13 Support	TYPO3 v12 Support
13.x	yes	no
12.x	no	yes

Outdated Versions

For all other versions no more free bug fixes and new features will be provided by the authors.

IP Database

This site or product includes IP2Location LITE data available from https://lite.ip2location.com.

Contributing

You can contribute by making a pull request to the master branch of the extension repository on GitHub. Or just send us some beers 🍻...

Documentation

You are welcome to help improve this guide. Just click on "Edit on GitHub" on the top right to submit your change request.

Changelog

This chapter provides an overview of changes. Take a deeper look on a version listed below, to see which bugs have been fixed, which new features have been introduced, and what you should not use anymore.

List of Versions

Version 1.0.2 - 2026/03/24

This release replaces the alternative text label with the correct TYPO3 core locallang key.

Download

Download this version from the TYPO3 extension repository or from GitHub.

All Changes

This is a list of all changes in this release:

2026-03-23 [TASK] fixing code-style [YODA-2802] (Commit 5e82c2d by sagitov)
2026-03-23 [TASK] setting TYPO3 core locallang key for alternative text label [YODA-2802] (Commit 4bf1a21 by sagitov)

Contributors

Following people have contributed to this release:

Akhmed Sagitov

Thank you very much for your support. The next beer is on us! 🍻

Version 1.0.1 - 2026/03/19

This release is a bug fix release.

Download

Download this version from the TYPO3 extension repository or from GitHub.

All Changes

This is a list of all changes in this release:

2026-03-19 [TASK] removing minimum-stability from composer.json [YODA-2802] (Commit 2ba3fa3 by Akhmed Sagitov)

Contributors

Following people have contributed to this release:

Akhmed Akhmed Sagitov

Thank you very much for your support. The next beer is on us! 🍻

Version 1.0.0 - 2026/03/19

This is the initial public relase of this extension.

Download

Download this version from the TYPO3 extension repository or from GitHub.

All Changes

This is a list of all changes in this release:

2026-03-11 [TASK] adding service unit test (Commit 1bf9021 by Akhmed Sagitov)
2026-03-11 [TASK] adding Viewhelper (Commit 23c485c by Akhmed Sagitov)
2026-03-11 [TASK] adding Service (Commit df626e6 by Akhmed Sagitov)
2026-03-11 [TASK] adding FileReferenceRepository (Commit b4ea072 by Akhmed Sagitov)
2026-03-10 [TASK] adding template into extension (Commit 8b69430 by Akhmed Sagitov)
2026-03-10 [TASK] adding tsconfig and overriding backend template path (Commit 620348b by Akhmed Sagitov)
2026-03-10 [TASK] adding referencesHaveMissingAltText methode (Commit 135f2a9 by Akhmed Sagitov)
2026-03-10 [TASK] adding ext_emconf.php (Commit 413d88c by Akhmed Sagitov)
2026-03-10 [TASK] adding eventlistener to set Icon (Commit f4091b3 by Akhmed Sagitov)
2026-03-10 [TASK] adding readme file (Commit 40347cc by Akhmed Sagitov)
2026-03-10 [TASK] creating a new extension (Commit d66b8a7 by Akhmed Sagitov)

Contributors

Following people have contributed to this release:

Akhmed Akhmed Sagitov

Thank you very much for your support. The next beer is on us! 🍻