Attention

TYPO3 v12 has reached end-of-life as of April 30th 2026 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here: TYPO3 ELTS.

Extension folder `Configuration/Backend`

The folder EXT:my_extension/Configuration/Backend/ may contain configuration that is important within the TYPO3 Backend.

All files in this directory are automatically included during the TYPO3 bootstrap.

AjaxRoutes.php

Scope: extension
Path (Composer): packages/my_extension/Configuration/Backend/AjaxRoutes.php
Path (Classic): typo3conf/ext/my_extension/Configuration/Backend/AjaxRoutes.php

In this file routes for Ajax requests that should be used in the backend can be defined.

Read more about Using Ajax in the backend.

EXT:my_extension/Configuration/Backend/AjaxRoutes.php

<?php
return [
    'example_dosomething' => [
        'path' => '/example/do-something',
        'target' => \Vendor\MyExtension\Controller\ExampleController::class . '::doSomethingAction',
    ],
];

Routes.php

Scope: extension
Path (Composer): packages/my_extension/Configuration/Backend/Routes.php
Path (Classic): typo3conf/ext/my_extension/Configuration/Backend/Routes.php

This file maps the URI paths used in the backend to the controller that should be used.

Most backend routes defined in the TYPO3 core can be found in the following file, which you can use as example:

EXT:backend/Configuration/Backend/Routes.php (GitHub)

Extension folder Configuration/Backend

Configuration/Backend/AjaxRoutes.php

Configuration/Backend/Routes.php

Configuration/Backend/Modules.php

Extension folder `Configuration/Backend`