Shop templates

Open Shop → Design → Look and select Browse templates.

Choose a Bottle template

Search the template library, select a design and choose Use in draft. Check the shop preview, then publish when you are ready.

Bottle templates change colours, fonts, spacing and product-card styles. They keep your logo, products, homepage content, other pages, prices and checkout settings.

Upload your own design

You or your designer can build your own shopfront with HTML, CSS and JavaScript, then upload it as a ZIP. It does not need to use Yard or Flame. You can also ask Claude or ChatGPT to create one using the custom template guide.

1. Download the complete template example from the library.
2. Edit its layout, colours and interactions. Keep bottle.template.json at the root of the ZIP.
3. Open Upload and drop the ZIP into the upload area, or choose it from your computer.
4. Bottle checks the files and shows which page layouts the template provides.
5. Choose Use in draft, check the preview on desktop and mobile, then publish.

The template can provide its own homepage, catalogue, category and content-page designs. Product details, basket, sign-in, accounts, checkout and payments stay on Bottle’s supported pages. Your products, customer records, orders, prices and existing page content are preserved.

Templates run separately from Bottle’s protected pages and only receive public shop data. Upload code from a source you trust: a poorly written template can still look misleading or run slowly in a visitor’s browser. WordPress PHP themes and plugins are not compatible.

A simpler colour-theme pack

If you only want to change colours, fonts and built-in sections, use a Bottle theme pack instead. The colour-theme format guide explains this JSON option.

1. Download the starter pack from the template library.
2. Customise the pack. Its filename must end in .bottle-theme.json.
3. Open Upload and drop the file into the upload area, or choose it from your computer.
4. Review its name and description. If it includes a new homepage layout, confirm that you want to replace your draft’s homepage sections.
5. Choose Use in draft, check the preview, then publish.

Uploading or applying a theme does not change the live shop. Your current design stays live until you publish the draft.

JSON colour-theme packs use Bottle’s built-in components; they do not contain executable code. Use a template ZIP if you need your own HTML, CSS and JavaScript.

Use a previous theme

Open Saved themes, choose a version, review it and select Use in draft. This applies its design to your draft; preview and publish it as usual.

This restores the saved theme, not all shop content or business settings. A JSON colour-theme pack with bundled homepage sections replaces those sections only after you confirm it. A code template changes the layout without replacing those sections.

To undo unpublished work, use the shop’s existing Discard changes action. This returns the draft to the currently published settings.

Remove an unused theme

Select Remove beside a saved theme. You cannot remove a theme used by the draft or live shop. If only the draft uses it, apply a different theme to the draft. If the live shop uses it, publish a different theme before removing it.

A code template can also be kept for your assistant’s saved undo. Undo that change, or make a new assistant change that replaces it, before removing the template. If undo restores it to the draft, choose another template first.

Each business can keep up to 20 saved themes, within 40 MB of source packages and processed template bundles. A JSON theme pack can be up to 7 MB. A template ZIP can be up to 4 MB compressed, containing up to 8 MB of uncompressed files and 32 files. Either format supports up to eight JPEG, PNG or WebP pictures, each about 1 MB or less.

Uploads also have a 50 MB allowance over the last 24 hours. ZIP file checks count as well as imports, including attempts that fail while processing. Removing a saved theme does not reset the upload allowance. If you reach it, wait before uploading again; you can still use saved themes and Bottle templates.

If the theme cannot be uploaded, the current live shop stays unchanged. Check the error, correct the file and try again. Bottle checks uploads automatically; no support activation is needed.