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.
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 in Zid Partner Dashboard (for testing & uploading themes).
