# Migration

URL: /docs/theming/templating/kida/migration/
Section: migration

--------------------------------------------------------------------------------

Migration Most Jinja2 templates work without changes in Kida. Migrate incrementally to use unified &#123;% end %&#125; blocks, pattern matching, and pipeline operators. Note that Kida does not support all Jinja2 features (notably &#123;% macro %&#125;—use &#123;% def %&#125; instead). If you need full Jinja2 compatibility, use the Jinja2 engine by setting template_engine: jinja2 in your config. Migration Strategy Compatibility Mode — Existing Jinja2 templates work as-is Gradual Migration — Convert templates incrementally as you edit them Full Migration — Use Kida syntax throughout Quick Syntax Changes Jinja2 Kida &#123;% endif %&#125;, &#123;% endfor %&#125; &#123;% end %&#125; &#123;% set x = ... %&#125; &#123;% let x = ... %&#125; &#123;% if %&#125;...&#123;% elif %&#125; &#123;% match %&#125;...&#123;% case %&#125; | selectattr('key', 'eq', val) |&gt; where('key', val) | sort(attribute='key') |&gt; sort_by('key') | default(value) ?? value (simple) Note Note Template Functions: where and sort_by are Bengal template functions (not Kida built-ins) that are automatically available in all templates. They work with both \| (Jinja2-style) and \|&gt; (Kida pipeline) operators. Topics From Jinja2 Convert existing Jinja2 templates to Kida syntax

--------------------------------------------------------------------------------

Metadata:
- Author: lbliii
- Word Count: 178
- Reading Time: 1 minutes