---
title: "TypoScript configuration of modules"
manual: "TYPO3 Explained"
version: "14.3"
permalink: "https://docs.typo3.org/permalink/t3coreapi:backend-module-typoscript@14.3"
source: "ApiOverview/Backend/BackendModules/ModuleTypoScript.rst"
rendered: "2026-10-01T15:20:05+00:00"
---

# TypoScript configuration of modules {#backend-module-typoscript}

The backend module of an extension can be configured via TypoScript.
The configuration is done
in `module.tx_<lowercaseextensionname>_<lowercasepluginname>` or
in `module.tx_<lowercaseextensionname>`.
If the part `_<lowercasepluginname>` is omitted, then the setting is used
for all backend modules of that extension.

Even in the backend the frontend TypoScript setup is used. The settings should
be done globally and not changed on a per-page basis. Register them with
`\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addTypoScriptSetup()`
in the extension's [`ext_localconf.php`](../../../ExtensionArchitecture/FileStructure/ExtLocalconf.md#file-extension-ext-localconf-php):

**EXT:my_extension/ext_localconf.php**

```php
use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;

ExtensionManagementUtility::addTypoScriptSetup('
  module.tx_myextension.settings.itemsPerPage = 25
');
```

Do not use [ext_typoscript_setup.typoscript](https://docs.typo3.org/permalink/t3coreapi:ext-typoscript-setup-typoscript@14.3)
for this. It is not loaded on sites that use site sets, so a module showing a
page of such a site does not see it. A module without a page tree only sees
global TypoScript, see [Breaking: #105728](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/14.0/Breaking-105728-ExtbaseBackendModulesDoNotGuessPageIdForTypoScriptAnymore.html#breaking-105728-1732882067).

See the [toplevel object "module"](https://docs.typo3.org/m/typo3/reference-typoscript/14.3/en-us/TopLevelObjects/Module.html#tlo-module) in the
TypoScript reference for the available options.