---
title: "Migration from Fluid"
manual: "Handlebars"
version: "main"
permalink: "https://docs.typo3.org/permalink/cpsit/typo3-handlebars:migration-from-fluid@main"
source: "Guides/MigrationFromFluid/Index.rst"
rendered: "2026-09-29T09:05:57+00:00"
---

# Migration from Fluid {#migration-from-fluid}

This chapter is aimed at developers who are familiar with TYPO3's built-in Fluid
templating engine and want to adopt Handlebars for new or existing projects. It
explains the conceptual differences, maps Fluid constructs to their Handlebars
equivalents, and provides a step-by-step path for migrating an existing project
incrementally without a big-bang rewrite.

-   [Concept mapping](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:concept-mapping@main)
-   [Template syntax](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:template-syntax@main)
-   [Layouts and partials](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:layouts-and-partials@main)
-   [Helpers](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:helpers@main)
-   [Gradual migration](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:gradual-migration@main)