1. Templates
  • Getting Started
    • Introduction
    • Theme Development
    • Publishing Your Theme
    • Legacy Theme Migration
      • Store Settings Mapping
      • Moving to Vitrin Using LLMs
      • Twig to Jinja
      • Breaking Changes
  • Key Concepts
    • Architecture
    • Templates
      • Overview
      • Template Library
        • home.jinja
        • 404_not_found.jinja
        • account_wishlist.jinja
        • categories.jinja
        • page.jinja
        • reviews.jinja
        • account_addresses.jinja
        • blog.jinja
        • category.jinja
        • product.jinja
        • search.jinja
        • account_orders.jinja
        • blogs.jinja
        • faqs.jinja
        • products.jinja
        • shipping_payment.jinja
        • account_profile.jinja
        • cart.jinja
        • questions.jinja
        • wishlist.jinja
    • Settings
      • Sections
      • Input Settings
      • Media Settings
      • Form Controls Settings
      • Products Settings
      • Additional Settings
      • Conditional Visibility
      • Migrating twig settings schema
    • Localization
      • localization (jinja v. twig)
  • Building with Vitrin
    • Jinja Basics
    • Vitrin's Jinja Extensions
    • Objects Reference
  • Vitrin CLI
    • Introduction
    • CLI Commands
  • Tips & Tricks
    • Performance
  • Features
    • Loyalty
    • Bundle Products
  1. Templates

Overview

Templates define how each storefront route is rendered in Zid using Jinja2.
Each template file maps to a specific page type (e.g., product, cart, homepage) and determines the layout, sections, and components shown to customers.

Templates#

Each template in this list links to the Template Library, where you’ll find code examples and UI previews.
You can name components as sections as you please, however templates and layout files names and directories need to be standardized to something our system recognize.

Core Templates#

TemplatePurposeRoute
home.jinjaHomepage layout with banners, featured collections, or products./
product.jinjaInidvidual product details page./p/{product}
cart.jinjaShopping cart with items and totals./cart
category.jinjaSingle category page with product listings./c/{category}

Product Discovery Templates#

TemplatePurposeRoute
products.jinjaGeneral product listing (all products)./p
search.jinjaDisplays search results./search?q=term
categories.jinjaOverview of categories with links./categories

Account Templates#

TemplatePurposeRoute
account_profile.jinjaCustomer profile management./account/profile
account_orders.jinjaCustomer order history./account/orders
account_addresses.jinjaCustomer address book./account/addresses
account_wishlist.jinjaCustomer wishlist management./account/wishlist

Content Templates#

TemplatePurposeRoute
blog.jinjaDisplays a single blog post./blog/{post}
blogs.jinjaBlog index page with posts list./blogs
page.jinjaGeneric CMS/content page./page/{slug}

Support Templates#

TemplatePurposeRoute
faqs.jinjaFrequently Asked Questions./faqs
questions.jinjaProduct-specific Q&A./questions
reviews.jinjaCustomer reviews section./reviews
shipping_payment.jinjaShipping & payment info page./shipping-payment

Utility Templates#

TemplatePurposeRoute
404_not_found.jinjaError page for missing content.
wishlist.jinjaStandalone wishlist page./account/wishlist

Key Features (All Templates)#

All templates extend the base template layout.jinja:
Common components like header and footer are included automatically.
Support for multilingual content with _( ) translations.
Assets are referenced with the asset_url filter:
Modified at 2025-08-17 11:04:12
Previous
Architecture
Next
home.jinja
Built with