Zid Docs
AppsThemes
Payments
AppsThemes
Payments
Help Center
Slack
  1. Getting Started
  • Getting Started
    • Introduction
    • Theme Development
    • Bnfsj Landing Page Development
    • Vitrin Changelog
    • Creating and Managing Theme Presets
    • Legacy Theme Migration
      • Moving to Vitrin Using LLMs
      • Twig to Jinja
      • Breaking Changes
      • Store Settings Mapping
  • Key Concepts
    • Architecture
    • Templates
      • Overview
      • Overridable Templates
      • Legacy Templates
      • Template Replacements
      • Templates Library
        • home.jinja
        • product.jinja
        • cart.jinja
        • category.jinja
        • products.jinja
        • categories.jinja
        • page.jinja
        • blogs.jinja
        • blog.jinja
        • faqs.jinja
        • reviews.jinja
        • questions.jinja
        • shipping_payment.jinja
        • 404_not_found.jinja
        • brands.jinja
        • brand.jinja
    • Settings
      • Schema files
      • Input Settings
      • Media Settings
      • Form Controls Settings
      • Products Settings
      • Additional Settings
      • Conditional Visibility
      • Migrating twig settings schema
    • Localization
      • localization (jinja v. twig)
    • Theme Editor
      • Overview
  • Building with Vitrin
    • Jinja Basics
    • Vitrin's Jinja Extensions
  • Vitrin CLI
    • Introduction
    • CLI Commands
  • Tips & Tricks
    • Performance
  • JS Integration
    • Supporting both Vitrin and Legacy themes
    • Responses & Errors
    • Cart
    • Products
    • Categories
    • Store
    • Account
    • Blogs
    • Options
    • Events
  • Features
    • SDK Popups – Integration Guidelines
    • Custom Styles Guide
    • Gift Card as a Popup
    • Addresses as a Popup
    • Login as a Popup
    • Checkout as a Popup
    • Apple Pay Quick Checkout
    • Region & Language Popup
    • Dynamic Bundle Products
    • Progressive Discounts
    • Bank Discounts
    • Customer Wallet & Cashback
    • Add Preorder Support to Your Theme
    • Display Product Options as Colors or Images
    • Coupon Form Visibility
    • New Gifting Experience
  • Mobile Apps
    • Scripts
    • Login & Checkout via Page Views
    • Theme Sections Settings
  • API's
    • Authentication
      • Logout
      • Login Status
      • SMS Login
      • Verify SMS Login
      • WhatsApp Login
      • Verify WhatsApp Login
      • Email Login
      • Verify Email Login
      • Register
      • Register Guest
    • Products
      • List Products
      • Search Products
      • Calculate Product Options Price
      • Notify Product Stock Availability
      • Fetch Bundle Offers
      • Fetch Bundle Offers for a Product
      • List My Product Reviews
      • List Product Reviews
      • Create Product Review
      • Update Product Review
      • Delete Product Review
      • List Product Questions
      • Create Product Question
      • Get Product by Slug
      • Get Selection Groups
    • Categories
      • List Categories
    • Checkout
      • Get Cart
      • Remove Cart
      • Duplicate Cart
      • Add Cart Item
      • Empty Cart
      • Update Cart Item
      • Remove Cart Item
      • Upload Cart Input Field
      • Add Gift Card
      • Remove Gift Card
      • Apply Coupon
      • Remove Coupon From Cart
      • Check Coupon Validity
      • Apply Loyalty Points
      • Remove Loyalty Points
      • Preview Rewarded Points
      • List Redemption Methods for Cart
      • Customer’s Loyalty Wallet
      • Customer’s Current Points Balance
      • List Bank Discounts
    • Account
      • Get Profile
      • Delete Account
      • Update Customer Profile
      • Get Addresses
      • Create an Address
      • Get an Address by ID
      • Update an Existing Address
      • Delete Address
      • Get Orders
      • Get Shareable Wishlist Link
      • Get Wishlist
      • Add Products to Wishlist
      • Remove Product from Wishlist
      • Get Address Form Schema
      • Check Product Purchase Status
    • Storefront
      • Store Scripts
      • Pages
      • Blogs
    • Countries
      • Get Countries
      • Get Cities By Country
  1. Getting Started

Vitrin Changelog

September 15, 2026
Feature UpdateProducts

Product Brands Theme Support#

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().
Read full post →
August 20, 2026
Action RequiredPayment

Bank Discounts Theme Support#

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 →
December 23, 2025
Action RequiredFeature Update

Multi-Inventory & Region–Language Modal#

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 →
December 16, 2025
Performance

Grouped Products Template Update#

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 →
December 11, 2025
Action RequiredPayment

Apple Pay Quick Checkout Template Support#

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 →
December 7, 2025
Checkout

Checkout as a Pop-up#

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 →
December 4, 2025
Performance

UndefinedErrors Now Visible in Dev Preview#

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.
December 4, 2025
Performance

Updated Settings Mapping#

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 →
December 3, 2025
Performance

Validate Endpoint Now Available#

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 →
November 18, 2025
Performance

Image Handling & Performance Update#

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 →
November 18, 2025
ProductsCategoris

Route Updates for Products & Categories#

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
Read full post →
October 27, 2025
Action RequiredLogin

Customer Login as a Pop-up#

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 →
October 20, 2025
Action RequiredLogin

Customer Address as a Pop-up#

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 →
Modified at 2026-09-15 09:59:47
Previous
Bnfsj Landing Page Development
Next
Creating and Managing Theme Presets
Built with