Vitrin now supports Product Brands across the storefront.
Theme developers can use brands.jinja to display all store brands at /brands and brand.jinja to display a specific brand and its products at /brands/{slug_brand}.
The product.jinja template also now exposes product.brand.name and product.brand.logo, allowing themes to display the assigned brand on product pages.
Brand routes are not currently supported by url_for().
Vitrin now supports Bank Discounts, allowing merchants using ZidPay to offer discounts for eligible banks and card types, including Mada, Visa, and Mastercard. Theme developers are required to add the Bank Discounts shared template to both the product details and cart pages: `{% include 'vitrin:shared/bank_discounts.jinja' %}` Without this template, Bank Discounts configured by merchants will not appear on these pages. No theme changes are required for checkout.
[Read full post →](https://docs.zid.sa/bank-discounts-2332488m0)We’ve introduced support for the multi-inventory feature along with a new region & language selection modal. Theme developers are required to implement this update to ensure compatibility and enable full migration of remaining stores. This change should also be applied to previously released themes. QA test cases will be updated to cover this functionality moving forward.
Read full post →We’ve introduced a new template for grouped products as part of last week’s updates. Theme developers are required to apply this change to ensure compatibility with the latest Vitrin structure. What changed? A simple substitution of the old Twig template with the new Jinja template: Old (Twig): {{ template_for_product_grouped }} New (Jinja): {% include 'vitrin:products/grouped-product.jinja' %}
[Example implementation →](https://github.com/zidsa/soft-theme-vitrin/commit/574ea3d5b6a8a6ded6b1a6607d7590cd974c4222)Vitrin now fully supports the new Apple Pay Quick Checkout template, enabling faster and more seamless checkout experiences for customers. All theme developers are required to update their themes to use this new template as soon as possible to prevent any checkout issues.
[Read full post →](https://docs.zid.sa/apple-pay-quick-checkout-1859764m0)The checkout popup feature allows customers to display the checkout page inside a modal dialog instead of redirecting customers away from the current page. When enabled, this creates a smoother, faster checkout experience and allows customers to complete their purchase without losing context.
[Read full post →](https://docs.zid.sa/checkout-as-a-popup-1806668m0)Undefined-variable errors are now displayed in the development preview environment. 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.
The Store Settings Mapping page has been updated with corrected and complete mappings. Developers should review the page to ensure their themes reflect the correct configuration behavior.
[Read full post →](https://docs.zid.sa/store-settings-mapping-1379317m0)We’ve added a new /validate endpoint is now available for all partners. Use it to instantly validate theme files, catch issues early, and shorten the testing cycle.
[Read full post →](https://docs.zid.sa/theme-development#theme-testing)We’ve added a detailed guide in the Performance page for the new `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.
[Read full post →](https://docs.zid.sa/performance-1379358m0)**Products Route:** 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`. --- **🚨 IMPORTANT:** Always use the `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 link ](https://github.com/zidsa/soft-theme-vitrin/blob/36c31cb1aaa2116c7be9527d12b707ce63bdc213/templates/reviews.jinja#L15)
[Read full post →](https://docs.zid.sa/overview-1379323m0)The login popup feature allows users to authenticate without leaving the current page. When enabled, it provides a modal dialog for user login, creating a smoother and more seamless user experience.
[Read full post →](https://docs.zid.sa/login-popup-1702155m0)The address dialog feature allows users to add or edit their shipping addresses without leaving the current page. When enabled, it provides a modal dialog for address management, creating a smoother and more seamless user experience.
[Read full post →](https://docs.zid.sa/addresses-popup-1706785m0)