Zid Docs
AppsThemes
Payments
AppsThemes
Payments
Help Center
Slack
  1. Getting Started
  • Getting Started
    • Introduction
    • Theme Development
    • Vitrin Changelog
    • Creating and Managing Theme Presets
    • Legacy Theme Migration
      • Store Settings Mapping
      • Moving to Vitrin Using LLMs
      • Twig to Jinja
      • Breaking Changes
  • 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
    • 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
    • Customer Wallet & Cashback
    • Add Preorder Support to Your Theme
  • Mobile Apps
    • Scripts
  • 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
    • 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

Creating and Managing Theme Presets

This guide explains how Zid partners can customize a theme through a development store, export the customization as a JSON file, and upload it as a theme preset. Theme presets allow merchants to quickly apply ready-made designs without manual configuration.
💡

Who this guide is for#

Zid theme partners
Partners managing custom or public themes
Partners creating ready-made theme presets for merchants

Prerequisites#

Before you begin, make sure that:
You have access to the Zid Partner Dashboard
You have at least one development store
The theme you want to customize already exists in My Themes
The theme supports presets

Part 1: Open the theme in the Partner Dashboard#

1.
Log in to the Zid Partner Dashboard
Screenshot 2026-02-04 123727.png
3.
From the left-side menu, go to Themes Analytics
4.
Click My Themes
5.
Under the Themes tab, locate the required theme (for example, Vetro)
6.
Click the Edit (✏️) icon next to the theme to open the Theme Details page
From the Theme Details page, you can manage versions, images, and presets for the selected theme.

Part 2: Access the merchant dashboard (Dashboard Access)#

To customize a theme visually, you must access a merchant store using Dashboard Access.
1.
In the Partner Dashboard, go to Development Stores
Screenshot 2026-02-04 123818.png
3.
Locate the development store you want to use
4.
Click Dashboard Access
This action opens the merchant dashboard for the selected store in a new tab, allowing you to customize the theme as a merchant would.

Part 3: Customize the theme in the merchant dashboard and export presets#

In this step, you will visually customize the theme and export the configuration as a JSON preset file.
1.
In the merchant dashboard, go to Online Store
Screenshot 2026-02-04 123951.png
3.
Click Themes
4.
Under Current Theme, click Customize
Screenshot 2026-02-04 124135.png
6.
Use the Theme Editor to customize the theme as needed, such as:
Adding or rearranging sections
Modifying colors, typography, and layout
Updating homepage or section settings
7.
Once customization is complete, click Export
Screenshot 2026-02-04 124538.png
7.
Save the exported file in JSON format
This JSON file represents the complete theme configuration and will be used to create a ready-made theme preset for merchants.

Part 4: Upload a new theme version and presets (Partner Dashboard)#

After exporting the preset, return to the Partner Dashboard to upload the theme version and preset files.

Upload a new theme version#

1.
Go back to the Theme Details page in the Partner Dashboard
Screenshot 2026-02-04 124738.png
3.
Open the Theme versions section
4.
Select the Change Type:
Major – for significant updates or new features
Minor – for incremental improvements
Patch – for bug fixes
5.
Upload the Theme ZIP file
Screenshot 2026-02-04 124855.png
6.
Add the Change Log (in English and Arabic if required)

Upload the preset file#

6.
Upload the exported preset JSON file
Screenshot 2026-02-04 124945.png
8.
Review all uploaded files to ensure accuracy
9.
Click Submit for Review
Or click Activate if the version does not require review
Once submitted, the theme version and preset will be processed according to Zid’s review and publishing workflow.

What happens next#

The uploaded preset becomes available as a theme preset
Merchants can apply the preset instantly without manual customization
Presets help ensure consistent design experiences across stores

Best practices#

Use clear and descriptive names for presets
Test presets thoroughly in a development store before uploading
Keep preset images and JSON files aligned with the theme’s assets
Document what each preset is designed for (e.g. fashion, electronics, minimal layout)
Modified at 2026-02-17 07:02:10
Previous
Vitrin Changelog
Next
Legacy Theme Migration
Built with