---
title: "Feature: #79140 - Add hook to add custom TypoScript templates"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-79140"
source: "Changelog/8.6/Feature-79140-AddHookToAddCustomTypoScriptTemplates.rst"
modified: "2026-09-15T10:46:36+00:00"
---

# Feature: #79140 - Add hook to add custom TypoScript templates

See [forge#79140](https://forge.typo3.org/issues/79140)

## Description

A new hook in TemplateService allows to add or modify existing TypoScript templates.

Register the hook via `$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['Core/TypoScript/TemplateService']['runThroughTemplatesPostProcessing']`
in the extensions' ext_localconf.php file.

## Example

An example implementation could look like this:

EXT:my_site/ext_localconf.php

```php
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['Core/TypoScript/TemplateService']['runThroughTemplatesPostProcessing'][1313131313] =
   \MyVendor\MySite\Hooks\TypoScriptHook::class . '->addCustomTypoScriptTemplate';
```

EXT:my_site/Classes/Hooks/TypoScriptHook.php

```php
namespace MyVendor\MySite\Hooks;

class TypoScriptHook
{

   /**
    * Hooks into TemplateService after
    * @param array $parameters
    * @param \TYPO3\CMS\Core\TypoScript\TemplateService $parentObject
    * @return void
    */
   public function addCustomTypoScriptTemplate($parameters, $parentObject)
   {
      // Disable the inclusion of default TypoScript set via TYPO3_CONF_VARS
      $parameters['isDefaultTypoScriptAdded'] = true;
      // Disable the inclusion of ext_typoscript_setup.txt of all extensions
      $parameters['processExtensionStatics'] = false;

      // No template was found in rootline so far, so a custom "fake" sys_template record is added
      if ($parentObject->outermostRootlineIndexWithTemplate === 0) {
         $row = [
            'uid' => 'my_site_template',
            'config' => '<INCLUDE_TYPOSCRIPT: source="FILE:EXT:my_site/Configuration/TypoScript/site_setup.t3s">',
            'root' => 1,
            'pid' => 0
         ];
         $parentObject->processTemplate($row, 'sys_' . $row['uid'], 0, 'sys_' . $row['uid']);
      }
   }
}
```