---
title: "Migration from Fluid"
manual: "Handlebars"
version: "1.0"
permalink: "https://docs.typo3.org/permalink/cpsit/typo3-handlebars:migration-from-fluid@1.0"
source: "Guides/MigrationFromFluid/Index.rst"
rendered: "2026-09-29T09:06:05+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@1.0)
-   [Template syntax](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:template-syntax@1.0)
-   [Layouts and partials](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:layouts-and-partials@1.0)
-   [Helpers](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:helpers@1.0)
-   [Gradual migration](https://docs.typo3.org/permalink/cpsit/typo3-handlebars:gradual-migration@1.0)