---
title: "TypoScript configuration"
manual: "TYPO3 Explained"
version: "12.4"
permalink: "https://docs.typo3.org/permalink/t3coreapi:extbase-typoscript-configuration@12.4"
source: "ExtensionArchitecture/Extbase/Reference/TypoScriptConfiguration.rst"
rendered: "2026-10-21T15:29:37+00:00"
---

> [!WARNING]
> **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](https://typo3.com/services/extended-support-elts).

# TypoScript configuration {#extbase-typoscript-configuration}

Each Extbase extension has some settings which can be modified using TypoScript.
Many of these settings affect aspects of the internal configuration of Extbase
and Fluid. There is also a block `settings` in which you can
set extension specific settings that can be accessed in the controllers and
Fluid templates of your extension.

TypoScript for all frontend plugins can be set in the typoscript block
`plugin.tx_[lowercasedextensionname]`, for example
`plugin.tx_blogexample`.

TypoScript for a specific frontend plugin can be set in the typoscript block
`plugin.tx_[lowercasedextensionname]_[pluginname]`, for example
`plugin.tx_blogexample_postsingle`. Settings made here override
settings from `plugin.tx_blogexample`.

TypoScript for all [backend modules](https://docs.typo3.org/permalink/t3coreapi:backend-module-typoscript@12.4) can be set
in `module.tx_[lowercasedextensionname]`, for example
`module.tx_blogexample`, for a specific backend module in
`module.tx_<lowercaseextensionname>_<lowercasepluginname>`.

For details of the available configuration values see
[plugin in the TypoScript Reference](https://docs.typo3.org/m/typo3/reference-typoscript/12.4/en-us/TopLevelObjects/Plugin.html#plugin).

## Plugin configuration {#plugin-configuration}

**EXT:blog_example/Configuration/TypoScript/setup.typoscript**

```typoscript
plugin.tx_blogexample {
    settings {
        postsPerPage = 3
    }
}

```

In the controller use `$this->settings['postsPerPage']` to access the TypoScript
setting.