Commera

Commera

Open in ChatGPT
Ask ChatGPT about this page
Open in Claude
Ask Claude about this page

Hand it to your client

Every setting in your .json files is a field in the theme editor. This page shows what your client sees, so you know what to tell them.

The Offer block of the sale banner: each setting in the JSON file on the left is joined by a line to the field it makes in the editor on the right

On the left is the offer block from sale_banner.json. On the right is the form the editor makes from it.

  • name is the heading of the form.
  • Each setting is one field. label is the name above it, and type says what kind of field it is: image makes an Upload button, textarea makes a box for a few lines, and text and url make one line.
  • The default is what the field holds until the merchant types something else.

You wrote no form code. Add a setting to the file and the field is there when you reload the editor.

What your client does

Your client needs a login to /commera. Then:

  1. Open Storefront, then Themes, and click Diwali.

    The Themes page with Diwali as the live theme
  2. Add a section. Click + next to Home page. Your sections are in the list, in the groups you gave them with category.

    The Add section list
  3. Change the words. Click Hero in the list on the left. The form on the right has the fields from hero.json. The preview changes as they type. The Background drop-down is the select you made.

    The Hero form with the heading changed and the Background set to Blush; the preview shows a pink hero
  4. Swap a photo. Click the arrow next to Sale banner, then click the second Offer. Click Upload next to Image and choose a photo from the computer.

    The second Offer with a dress photo uploaded; the preview shows the photo in the offer
  5. Compare desktop and mobile. Click the ... button under the preview, and choose Desktop and mobile, the third icon.

    The editor showing the desktop preview and the phone preview side by side
  6. Click Save, then Publish. Save keeps the changes as a draft, and the badge at the top says Unpublished changes. Publish puts them on the store.

    The editor after Publish: the badge says Published and a message says Published to your store

Colours and fonts are separate

Colours and fonts are not in a section. The client opens Theme settings, at the bottom left, and changes Brand Colour or a font. This panel has its own Save button at the bottom, apart from the Save and Publish at the top.

Theme settings with Brand Colour changed to a plum colour; the preview buttons and sale banner are plum

The change reaches the store as soon as the panel's Save is clicked. Publish is not needed.

What to tell your client

  • Save keeps a draft. Publish makes it live.
  • Colours and fonts have their own Save, and need no Publish.
  • Photos they upload are kept on the site. They are not in your app.
  • Their changes stay on their site. If you change a section file later, a page they have published does not pick it up. Ship it explains why.

Next steps

Last updated 2 weeks ago
Was this helpful?
Thanks!