Help Desk
العربية
Go to dashboard

Theme editor

The theme editor is where you build your storefront's home page and set your theme's general settings, with a live preview beside them. Open it from Online store > Themes by selecting Customize on the Current theme card or on a theme in Theme library. It opens in a new tab.

Your changes are saved as a draft as you make them. Customers see them only after you select Publish.

This page describes the editor for themes built for the enhanced storefront. Older themes open the classic theme editor instead, and customizing them depends on your plan.

The editor layout

The theme editor in Arabic, with the top bar, the storefront preview and the Home page sections sidebar
Personal details are covered.

The top bar holds the editor's controls:

The right end of the editor's top bar, with Publish, History, the more-actions menu and the preview size buttons
Personal details are covered.
ControlWhat it does
BackReturns to the page you came from, such as Themes, Landing pages or Markets.
Published / DraftShows whether the theme has changes that aren't published yet.
Page selectorChooses the page you are editing: Home page, or a page under Product landing pages.
LanguageSwitches between English and العربية. Each language has its own content, so edit both.
MarketAppears when your store sells in several markets. Customizes the theme for one market; Primary marks your main market.
Desktop, mobile, full screenChange the preview size. Full screen hides the sidebar.
More actions (⋯)Holds Export, Import and Preview.
HistoryOpens the version history.
PublishMakes your draft changes live.

The sidebar on the left lists the page's sections under Home page sections, and the preview on the right shows your storefront as you edit it. Select the settings icon at the top of the sidebar to switch to Page settings.

Edit a section

The sections are grouped into Header, Page content and Footer, each with its number of sections.

The Home page sections sidebar with the Header group open, listing header settings, the logo and the announcement bar
Personal details are covered.
  1. Select a section in the sidebar. The preview scrolls to it.

  2. Change its settings. Each change is saved to your draft and shown in the preview.

  3. Select the back arrow next to the section name to return to the list.

The settings depend on the section and the theme. Common ones are text and rich text, numbers and ranges, colors, images and videos you upload or pick, checkboxes and options, and lists of items you build with Add item and Edit item.

  • Links can point to a Category, Product, Custom page, Legal page, a Blog post you choose in Select Blog, the Faqs page, or Other for any web address. To link your whole blog, choose Other and enter your store address followed by /blogs.

  • Products settings let you show Select products, Category products, Recent products or On sale products. With Create new category you can group products for a section in a category that is used only for organization and doesn't appear in your storefront.

For example, the Header group of one enhanced theme has these sections:

  • Header settings, to hide the language or the country name in the storefront header.

A theme's header settings, with the options to hide the language and the country name
Personal details are covered.
  • The logo, with a desktop logo of 200 × 80 pixels and a mobile logo of 150 × 60 pixels, both optional. Other themes can ask for other sizes.

A theme's logo section, with the desktop and mobile logo uploads and their sizes
Personal details are covered.
  • The announcement bar: show it, turn on scrolling and set its speed, add its texts and link, and choose the pages that show it.

A theme's announcement bar section, with the show and scrolling options, the speed, the texts, the link and the pages that show it
Personal details are covered.

Each theme expects its own image sizes. Check the theme's details page, or the developer's Custom Theme Steps guide when there is one, for the right dimensions, so your images look sharp and fit their sections. See Theme details.

Add, reorder and manage sections

The Page content group holds the sections of the page body.

The Page content group with a product list section and the Add section button
Personal details are covered.
  • Add a section: select Add section under the list. In the Add new section dialog, search with Search by section name, choose a section, such as a gallery, a product list or a slider, and select Add.

The Add new section dialog with the section search and a list of sections to choose from
Personal details are covered.
  • Reorder: drag a section up or down in the list.

  • Manage: open a section's options menu to Hide or Show it, Rename it, Duplicate it, copy it to the other language (Copy section to English language while you edit in Arabic), or Delete it. Hidden sections stay in the list with a hidden icon.

Header and Footer hold the top and bottom of every page. You can edit their settings but not reorder them. In one theme, for example, the footer holds the logo, link groups, about the store and contact details.

A theme's Footer group with the logo, link groups, about the store and contact details sections
Personal details are covered.

To reuse a section you built in Arabic, open its options menu and copy it to the English language, then translate its text there.

Create a section with AI

When your theme supports it, the editor can generate a section from a description.

  1. Select Add section and choose the AI generator at the top of the list, or select the Zid AI tool card in the sections list. The AI generator panel opens.

  2. Describe the section in Describe what you want to build: its content, layout and what you want to edit later. You can start from an example such as Collection carousel, About us, Testimonials or Promotional banner.

  3. Send your description. The section is added to the page as soon as it's ready, so you can close the panel and keep working.

  4. To improve it, open the section and describe the change in Want to improve something? Just share.

Generated sections carry an AI Generated tag. You can create a limited number of AI sections each day; the panel shows how many you have left. Your past chats appear in the panel's history, and New chat starts a fresh one.

Change the theme settings

Page settings holds the theme's general settings, such as colors, fonts and the layout of shared elements. The groups depend on the theme. These settings apply across all pages of the theme.

  1. Select the settings icon at the top of the sidebar.

The top of the sidebar, with Home page sections and the settings icon
Personal details are covered.
  1. Open a group and change its settings, such as the product card, the font type or the theme colors.

Page settings with the product card and font groups, and the font type set to IBM Arabic
Personal details are covered.

The theme colors group sets each color with a picker or a hex code:

A theme's colors in Page settings, each with its color picker and hex code
Personal details are covered.
  1. Select the close icon to return to the sections.

Switch layouts with presets

Some themes offer presets: ready-made arrangements of the home page.

  1. In the sections list, select Preview presets next to Switch layouts in one click.

  2. Browse the presets. Each one has its own tab with preview images.

  3. Select Apply, then Apply again in Apply changes to current theme?

Applying a preset clears your current customization and replaces your sections with the preset's structure. Your content is filled in where possible. This can't be undone.

Publish or undo your changes

While you have unpublished changes, a bar at the bottom of the editor says Unpublished changes detected.

  • Select Publish to make the changes live in your storefront. The status changes to Published.

  • Select Undo all changes to discard every change since your last publish.

Restore an earlier version

  1. Select History in the top bar.

  2. In Version history, find the version by its date. Published versions are marked Published, and your current one Current version.

The version history panel with the current version and an earlier published version, each with its date
Personal details are covered.
  1. Select Restore and confirm in Restore version?

Preview, export and import

  • Preview (in the more-actions menu) opens your storefront with the draft in the selected language, in a new tab.

  • Export downloads the theme's settings as a JSON file, so you can keep a copy.

  • Import uploads a JSON file you exported earlier and applies its settings to the theme.

Customize a product landing page

Product landing pages use the same editor. Open one with Customize on the Landing pages page, or choose it under Product landing pages in the page selector. For a landing page, the editor has no history, presets, export or import, and Preview opens the landing page itself.

Did this article solve your problem?
Your answer helps us see what needs improving.

Still need help?

Our customer service team is ready to help, or find quick answers in the FAQ.

Contact usRead the FAQ