konradmichalik/typo3-environment-indicator

Environment Indicator - TYPO3 extension with several features to show an environment indicator in the TYPO3 frontend and backend.

3.5.0 2026-08-11 08:00 UTC

Requires

• php: ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• ext-dom: *
• ext-filter: *
• ext-libxml: *
• ext-mbstring: *
• intervention/image: ^3.11.7 || ^4.0
• konradmichalik/php-color: ^0.2
• konradmichalik/php-ico-file-loader: ^0.3
• meyfa/php-svg: ^0.16
• psr/http-factory: ^1.1.0
• psr/http-message: ^1.0 || ^2.0
• psr/http-server-handler: ^1.0.2
• psr/http-server-middleware: ^1.0.2
• psr/log: ^3.0.2
• symfony/console: ^7.0 || ^8.0
• symfony/expression-language: ^7.0 || ^8.0
• symfony/mime: ^7.0 || ^8.0
• typo3/cms-backend: ^13.4.23 || ^14.3
• typo3/cms-core: ^13.4.23 || ^14.3
• typo3/cms-dashboard: ^13.4.23 || ^14.3
• typo3/cms-fluid: ^13.4.23 || ^14.3
• typo3fluid/fluid: ^4.2 || ^5.0

Requires (Dev)

• eliashaeussler/typo3-vendor-bundler: ^4.1.1
• eliashaeussler/version-bumper: ^4.0.4
• konradmichalik/ttt: ^0.4.0
• phpunit/phpcov: ^10.0 || ^11.0 || ^13.0
• phpunit/phpunit: ^11.0 || ^12.0 || ^13.0
• typo3/cms-base-distribution: ^13.4 || ^14.3
• typo3/cms-lowlevel: ^13.4 || ^14.3
• typo3/testing-framework: ^9.6.1

Suggests

• ext-gd: Required for image processing and rendering of SVG icons.
• ext-imagick: Required for image processing and rendering of SVG icons with Imagick support.
• intervention/image-driver-vips: Required for image processing and rendering of SVG icons with VIPS support.

GPL-2.0-or-later

• Konrad Michalik

Published on Packagist.org on 2026-08-11 08:01 UTC

README

TYPO3 extension typo3_environment_indicator

This extension provides several features to show an environment indicator in the TYPO3 frontend and backend, and beyond (CLI, mails).

Note

Has it ever happened to you that you changed data on a test system and then realized: oh no, that's the live system. Well, to prevent that from happening (again), I created this extension.

✨ Features

Icon	Preview	Feature
Frontend + Backend
		Modified favicon Modify the favicon for frontend and backend based on the original favicon, the current application context and your configuration.
		Page title Prefix or suffix the page title in frontend and backend with the current application context.
		Browser console badge Print a styled environment badge to the browser console in frontend and backend.
Frontend
		Frontend hint Adds a draggable, removable hint to the frontend showing the website title and the current application context.
		Modified frontend image (opt-in) Modify frontend image based on the original image, the current application context and your configuration.
		HTTP response header (opt-in) Add a configurable HTTP response header with the current application context to frontend responses.
		Robots header (opt-in) Send an X-Robots-Tag header to keep non-production environments out of search engines.
Backend
		Backend toolbar item Adds an informative item with the current application context to the backend toolbar.
		Backend topbar (opt-in) Colorize the backend header topbar regarding the application context.
		Modified backend logo Modify the backend logo based on the original logo, the current application context and your configuration.
		Dashboard widget Render a dashboard widget according to the environment.
		Backend theme (experimental, opt-in) Colorize the entire TYPO3 v14+ backend (primary color, header, sidebar) based on the environment.
		Backend login Show a colored environment badge directly on the backend login screen.
Misc
		CLI banner (opt-in) Print a colored environment banner to stderr before an interactive console command runs.
		Mail subject prefix Prepends the environment to the subject of every mail sent through the TYPO3 Mailer API.

Indicators marked (opt-in) are not part of the default configuration presets: either the extension configuration switch for them is off by default (CLI banner, backend theme), or they only ever do something once you register them yourself (frontend image, HTTP response header, robots header, backend topbar). Everything else works out of the box.

Note

These environment indicators are mainly for development purposes (e.g. distinguishing between different test systems) and will not show on the live production site by default. They do show in Production/Staging and Production/Standby application contexts, where they help distinguish those systems from the live site. Indicators you register yourself, such as the robots header, can still affect live production if you explicitly configure their triggers to do so.

🔥 Installation

Requirements

Version	TYPO3	PHP
3.x	13.4 - 14.x	8.2 - 8.5
2.x	11.5 - 13.4	8.1 - 8.4

Composer

Use the following composer command to install the extension:

composer require konradmichalik/typo3-environment-indicator

TER

Download the zip file from TYPO3 extension repository (TER).

📙 Documentation

Please have a look at the official extension documentation.

🧑‍💻 Contributing

Please have a look at CONTRIBUTING.md.

💎 Credits

This project is partly inspired by the laravel-favicon package.

⭐ License

This project is licensed under GNU General Public License 2.0 (or later).