# Theme Migration (Twig -> Vitrin)

:::danger[]
Themes built on the **Twig templating engine** are now **deprecated** and require migration to **Vitrin** to ensure continued support and compatibility with the Zid platform.
:::

---

> This guide will help you migrate your existing **Twig** themes into the new **Vitrin** system, step by step—from syntax changes in Jinja to the architectural improvements offered by Vitrin.
> 


## Migration Timeline
- **Migration window:** Developers can begin migrating their themes starting **01/08/2025**.  
- **Support cut-off:** All Twig themes will be deprecated by **28/12/2025**, and only Vitrin themes will remain supported in the Theme Market.  

---

## Why Migrate?
The new **Vitrin theming system** introduces major benefits over Twig-based themes:

- **Improved performance** → faster rendering, optimized asset loading, and better caching.  
- **Cleaner syntax with Jinja** → widely adopted, with clearer standards and more powerful features.  
- **Future-proof features** → support for new storefront APIs, versioned macros, and configurable schema settings.  
- **Consistent merchant experience** → default fallbacks, standardized settings, and cross-theme compatibility.  


:::check[]
Migrating ensures that your themes remain **usable, maintainable, and attractive** to Zid merchants.
:::

---

## Prerequisites
**Before you begin migration, make sure you have:**
- Access to your existing Twig theme source code.  
- A [partner account](https://partner.zid.sa) in Zid Partner Dashboard (for testing & uploading themes).  
---


<TipGood>
Start by reviewing [Store Settings Mapping](https://docs.zid.sa/store-settings-mapping-1379317m0) to understand how old settings translate into the new schema, then move on to [Moving to Vitrin Using LLMs](https://docs.zid.sa/moving-to-vitrin-using-llms-1379318m0) for practical migration tools.
</TipGood>


