Shop templates
The Template library changes how your Bottle Shop looks. Choose one of Bottle’s designs, or upload your own shopfront built with HTML, CSS and JavaScript.
Every change goes into your draft first. Your live shop stays as it is until you check the preview and publish, and your products, prices and checkout are never touched.
What you can do
Section titled “What you can do”- Bottle templates: choose a ready-made design from the library.
- Your own template: upload a ZIP with your own HTML, CSS and JavaScript.
- Colour-theme pack: change colours, fonts and built-in sections with a JSON file.
- Saved themes: put a design you used before back on your draft.
- Remove a saved theme: clear out themes you no longer use.
Before you start
Section titled “Before you start”- Set up your shop first. See Your shop. To open the library, go to Shop → Design → Look and select Browse templates.
Who can use it
Section titled “Who can use it”- Owners, admins and technical users: browse, upload, apply and remove templates, and publish the shop.
- Drivers: cannot change the shop.
Choose a Bottle template
Section titled “Choose a Bottle template”- Open Shop → Design → Look and select Browse templates.
- Search the library and select a design.
- 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
Section titled “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.
- Select Download a full template example in the library.
- Edit its layout, colours and interactions. Keep
bottle.template.jsonat the root of the ZIP. - Open Upload a theme and drop the ZIP into the upload area, or select Choose template file.
- Bottle checks the files and shows which page layouts the template provides.
- 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 own pages. Your products, customer records, orders, prices and existing page content are kept.
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 do not work.
Use a colour-theme pack
Section titled “Use a 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.
- Select Download starter pack in the library.
- Change the pack. Its filename must end in
.bottle-theme.json. - Open Upload a theme and drop the file into the upload area, or select Choose template file.
- Check its name and description. If it includes a new homepage layout, select Replace the homepage sections in my draft to confirm.
- Choose Use in draft, check the preview, then publish.
JSON colour-theme packs use Bottle’s built-in sections. They contain no code that runs. Use a template ZIP if you need your own HTML, CSS and JavaScript.
Use a previous theme
Section titled “Use a previous theme”- Open Saved themes.
- Choose a version and select Use this version.
- Preview the draft and publish as usual.
This puts back the saved theme’s design, not all shop content or business settings. A JSON colour-theme pack with its own homepage sections replaces those sections only after you confirm it. A code template changes the layout without replacing those sections.
To undo work you have not published, use Discard changes on the shop. The draft goes back to the published settings.
Remove an unused theme
Section titled “Remove an unused theme”- Open Saved themes.
- Select Remove beside the theme and confirm.
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 puts it back on the draft, choose another template first.
Questions
Section titled “Questions”Does uploading a theme change my live shop? No. Uploading or applying a theme does not change the live shop. Your current design stays live until you publish the draft.
How many themes can I keep? Each business can keep up to 20 saved themes, within 40 MB of uploaded files and processed templates.
How big can a file be? A JSON theme pack can be up to 7 MB. A template ZIP can be up to 4 MB compressed, with up to 8 MB of files inside and 32 files. Either can include up to eight JPEG, PNG or WebP pictures, each about 1 MB or less.
Is there a daily upload limit? Yes. Uploads have a 50 MB allowance over the last 24 hours. Checking a ZIP counts as well as importing it, including attempts that fail. Removing a saved theme does not reset the allowance. If you reach it, wait before uploading again. You can still use saved themes and Bottle templates.
Do I need support to switch on uploads? No. Bottle checks uploads itself.
If something goes wrong
Section titled “If something goes wrong”If a theme cannot be uploaded, your live shop stays as it is. Check the error, correct the file and try again.
| Problem | What to do |
|---|---|
| “Choose a ZIP template or a .bottle-theme.json theme pack.” | Upload a .zip or a file ending in .bottle-theme.json. |
| “This ZIP is too large. The limit is 4 MB.” | Make the pictures smaller or remove files you do not need. |
| “Bottle could not approve this template. Check the manifest and supported files in the guide.” | Check bottle.template.json is at the root of the ZIP. See the troubleshooting guide. |
| “This theme pack is not valid. Check the template guide and try again.” | Compare your pack with the starter pack and the colour-theme format guide. |
| “Save your current changes before applying a template.” | Save your draft, then apply the template. |
| “Your draft changed elsewhere. Reload the shop before trying again.” | Reload the page, then apply the template again. |
| “Your business has uploaded 50 MB of themes in the last 24 hours. Try again later. Removing a saved theme will not reset this allowance.” | Wait, then upload again. Use a saved theme or Bottle template meanwhile. |
| “Your business has 20 saved themes, or has reached 40 MB of saved themes. Remove an unused saved theme before adding another.” | Remove a theme you no longer use. |
| “This theme is used by your draft or live shop. Switch both to another theme before removing this one.” | Apply and publish a different theme, then remove it. |