Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.
🔁 Vitrin Changelog
December 4, 2025
Performance
UndefinedErrors Now Visible in Dev Preview
Themes that previously looked fine may now show errors—this is expected.
Use this update to fix missing fallbacks, handle optional values, and rely on safeget where needed.
December 4, 2025
Performance
Updated Settings Mapping
Developers should review the page to ensure their themes reflect the correct configuration behavior.
(https://docs.zid.sa/store-settings-mapping-1379317m0)
December 3, 2025
Performance
Validate Endpoint Now Available
Use it to instantly validate theme files, catch issues early, and shorten the testing cycle.
(https://docs.zid.sa/theme-development#theme-testing)
November 18, 2025
Performance
Image Handling & Performance Update
image_url helper, the equivalent of the old imageUrl function.We strongly recommend all developers use
image_url to generate responsive, optimized images, which greatly enhances performance and reduces page load time.November 18, 2025
ProductsCategoris
Route Updates for Products & Categories
Previously, both
/p and /products were supported. Now, only /products is valid./p will permanently redirect to /products.Categories Route:
/c now permanently redirects to /categories.url_for filter when generating links. Hard-coding URLs may break your theme if routes change again in the future.Example
url_for for a product details linkOctober 27, 2025
Action RequiredLogin
Customer Login as a Pop-up
October 20, 2025
Action RequiredLogin
Customer Address as a Pop-up
When enabled, it provides a modal dialog for address management, creating a smoother and more seamless user
experience.
Modified at 2025-12-04 07:56:24