---
title: "Hand it to your client"
space: "Commera"
url: "https://docs.bwh.tech/commera/build-a-section-theme/hand-it-to-your-client"
updated: "2026-11-07"
---

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.

<img src="/files/commera-05-hand-it-to-your-client-json-to-form-b075833b.png" alt="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" width="944">

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**.

   <img src="/files/commera-05-hand-it-to-your-client-themes-list-d3723c1e.png" alt="The Themes page with Diwali as the live theme" width="640">

2. Add a section. Click **+** next to **Home page**. Your sections are in the list, in the groups you gave them with `category`.

   <img src="/files/commera-04-add-sections-add-section-a972d8fe.png" alt="The Add section list" width="290">

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.

   <img src="/files/commera-05-hand-it-to-your-client-hero-edit-565d16bd.png" alt="The Hero form with the heading changed and the Background set to Blush; the preview shows a pink hero" width="944">

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.

   <img src="/files/commera-05-hand-it-to-your-client-offer-2-photo-0cdc0638.png" alt="The second Offer with a dress photo uploaded; the preview shows the photo in the offer" width="944">

5. Compare desktop and mobile. Click the **...** button under the preview, and choose **Desktop and mobile**, the third icon.

   <img src="/files/commera-05-hand-it-to-your-client-desktop-and-mobile-c18ec887.png" alt="The editor showing the desktop preview and the phone preview side by side" width="944">

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.

   <img src="/files/commera-05-hand-it-to-your-client-after-publish-9171766a.png" alt="The editor after Publish: the badge says Published and a message says Published to your store" width="944">

## 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.

<img src="/files/commera-05-hand-it-to-your-client-theme-settings-saved-0b38f3d6.png" alt="Theme settings with Brand Colour changed to a plum colour; the preview buttons and sale banner are plum" width="944">

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

:::note[Theme settings need the live theme]
The panel is for the live theme. If the theme is not live, the panel says "Activate Diwali to change its settings."
:::

## 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](/commera/build-a-section-theme/ship-it) explains why.

## Next steps

- [Ship it](/commera/build-a-section-theme/ship-it)
- [Section reference](/commera/build-a-section-theme/section-reference)
