---
title: "Overriding the Fluid template"
manual: "Indexed Search"
version: "14.3"
permalink: "https://docs.typo3.org/permalink/typo3/cms-indexed-search:configuration-fluidtemplating@14.3"
source: "Configuration/FluidTemplating/Index.rst"
rendered: "2026-09-19T11:27:55+00:00"
---

# Overriding the Fluid template {#configuration-fluidtemplating}

<!-- TODO: no Markdown rendering for "versionchanged" -->

It is recommended to use the site set settings to
override the template paths if possible.

The plugin "Indexed Search" can be extended with custom templates. You need
a custom [site package](https://docs.typo3.org/m/typo3/tutorial-sitepackage/main/en-us/Index.html#start) to achieve this.

The paths to the templates can also be extended in the [Settings editor](https://docs.typo3.org/permalink/typo3/cms-indexed-search:settings-editor@14.3).

**EXT:site_package/Configuration/Sets/SitePackage/settings.yaml**

```yaml
indexedsearch:
  view:
    templateRootPath: 'EXT:site_package/Resources/Private/Extensions/IndexedSearch/Templates/'
    partialRootPath: 'EXT:site_package/Resources/Private/Extensions/IndexedSearch/Partials/'
    layoutRootPath: 'EXT:site_package/Resources/Private/Extensions/IndexedSearch/Layouts/'

```

Now copy the Fluid templates that you want to override in the according paths
in your custom site package extension. For example to override the search form
copy the file `EXT:indexed_search/Resources/Private/Partials/Form.html`
to `EXT:site_package/Resources/Private/Extensions/IndexedSearch/Partials/Form.html`
and make your changes in the latter file.

## Overriding the template paths via TypoScript {#configuration-fluidtemplating-typoscript}

If you need to override the Fluid templates from multiple locations or for
legacy reasons you do not use [site sets](https://docs.typo3.org/permalink/typo3/cms-indexed-search:site-set@14.3) yet, you can use
TypoScript to override the template root paths:

The plugin "Indexed Search" can be extended with custom templates:

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

```typoscript
plugin.tx_indexedsearch.view {
  templateRootPaths {
    0 = EXT:indexed_search/Resources/Private/Templates/
    10 = {$plugin.tx_indexedsearch.view.templateRootPath ?? $indexedsearch.view.templateRootPath}
    20 = EXT:my_extension/Resources/Private/Templates/
  }

  partialRootPaths {
    0 = EXT:indexed_search/Resources/Private/Partials/
    10 = {$plugin.tx_indexedsearch.view.partialRootPath ?? $indexedsearch.view.partialRootPath}
    20 = EXT:my_extension/Resources/Private/Partials/
  }
}

```

The configuration in this TypoScript snippet will make the plugin look
templates in the following order:

-   Paths in `my_extension` (Index 20)
-   Paths defined by constant and if not defined by
    [settings](https://docs.typo3.org/permalink/typo3/cms-indexed-search:site-set-settings@14.3) (Index 10)
-   Fall back to the default `indexed_search` templates (Index 0)