---
title: "Installation"
manual: "Handlebars"
version: "main"
permalink: "https://docs.typo3.org/permalink/cpsit/typo3-handlebars:installation@main"
source: "Installation/Index.rst"
rendered: "2026-09-29T09:05:57+00:00"
---

# Installation {#installation}

## Requirements {#requirements}

-   PHP 8.2 - 8.5
-   TYPO3 13.4 LTS - 14.3 LTS

## Installation {#steps}

Require the extension via Composer (recommended):

```bash
composer require cpsit/typo3-handlebars
```

Or download it from the
[TYPO3 extension repository](https://extensions.typo3.org/extension/handlebars).

## Site sets {#site-sets}

The extension provides two [site sets](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/SiteHandling/SiteSets/Index.html#site-sets) that can be included in the site
configuration or any other site set.

-   `cpsit/handlebars` — **Handlebars base**

    -   Wires `plugin.tx_handlebars.view.templateRootPaths` and
        `plugin.tx_handlebars.view.partialRootPaths` from the site settings
        `handlebars.view.templateRootPath` and
        `handlebars.view.partialRootPath`.
    -   Include this set for every site that renders Handlebars templates.
-   `cpsit/handlebars-content-element` — **Handlebars content elements**

    -   Sets `lib.contentElement = HANDLEBARSTEMPLATE`, replacing the
        default Fluid base object used by EXT:fluid_styled_content.
    -   Include this set when all content elements should use Handlebars rendering by default.

**config/sites/\<my-site>/config.yaml**

```yaml
dependencies:
  - cpsit/handlebars
  - cpsit/handlebars-content-element
```

## Next steps {#installation-next-steps}

Continue with the [Quick start](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:quick-start@main) to render your first content element
with a Handlebars template.