Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

[Skip CI] Updated Storefront user docs (#13489)

jaburghesd7e3dc560741
diff --git a/docs/images/user/storefront/create-new-store/1-add-new-store.png b/docs/images/user/storefront/create-new-store/1-add-new-store.png
new file mode 100644
index 0000000000..63b70a1885
Binary files /dev/null and b/docs/images/user/storefront/create-new-store/1-add-new-store.png differ
diff --git a/docs/images/user/storefront/create-new-store/2-new-store-settings.png b/docs/images/user/storefront/create-new-store/2-new-store-settings.png
new file mode 100644
index 0000000000..bb3762e1de
Binary files /dev/null and b/docs/images/user/storefront/create-new-store/2-new-store-settings.png differ
diff --git a/docs/images/user/storefront/create-new-store/3-switch-stores.png b/docs/images/user/storefront/create-new-store/3-switch-stores.png
new file mode 100644
index 0000000000..d42f030a56
Binary files /dev/null and b/docs/images/user/storefront/create-new-store/3-switch-stores.png differ
diff --git a/docs/images/user/storefront/themes/create-new-theme/1-themes-tab.png b/docs/images/user/storefront/themes/create-new-theme/1-themes-tab.png
new file mode 100644
index 0000000000..ec4a96f7f3
Binary files /dev/null and b/docs/images/user/storefront/themes/create-new-theme/1-themes-tab.png differ
diff --git a/docs/images/user/storefront/themes/create-new-theme/2-clone-theme.png b/docs/images/user/storefront/themes/create-new-theme/2-clone-theme.png
new file mode 100644
index 0000000000..d09d6adee0
Binary files /dev/null and b/docs/images/user/storefront/themes/create-new-theme/2-clone-theme.png differ
diff --git a/docs/images/user/storefront/themes/create-new-theme/3-starter-theme.png b/docs/images/user/storefront/themes/create-new-theme/3-starter-theme.png
new file mode 100644
index 0000000000..90cc61567d
Binary files /dev/null and b/docs/images/user/storefront/themes/create-new-theme/3-starter-theme.png differ
diff --git a/docs/images/user/storefront/themes/create-new-theme/4-publish-theme.png b/docs/images/user/storefront/themes/create-new-theme/4-publish-theme.png
new file mode 100644
index 0000000000..21a0e4b35b
Binary files /dev/null and b/docs/images/user/storefront/themes/create-new-theme/4-publish-theme.png differ
diff --git a/docs/images/user/storefront/themes/delete-theme/1-theme-deletion.png b/docs/images/user/storefront/themes/delete-theme/1-theme-deletion.png
new file mode 100644
index 0000000000..df9605fab6
Binary files /dev/null and b/docs/images/user/storefront/themes/delete-theme/1-theme-deletion.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/1-themes-tab.png b/docs/images/user/storefront/themes/theme-editor/1-themes-tab.png
new file mode 100644
index 0000000000..31b0e80885
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/1-themes-tab.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/10-announcement-bar.png b/docs/images/user/storefront/themes/theme-editor/10-announcement-bar.png
new file mode 100644
index 0000000000..7da6cff741
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/10-announcement-bar.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/11-page-header.png b/docs/images/user/storefront/themes/theme-editor/11-page-header.png
new file mode 100644
index 0000000000..4542368600
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/11-page-header.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/12-add-blocks.png b/docs/images/user/storefront/themes/theme-editor/12-add-blocks.png
new file mode 100644
index 0000000000..96cce364dd
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/12-add-blocks.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/13-newsletter.png b/docs/images/user/storefront/themes/theme-editor/13-newsletter.png
new file mode 100644
index 0000000000..22f47a2dd5
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/13-newsletter.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/14-footer.png b/docs/images/user/storefront/themes/theme-editor/14-footer.png
new file mode 100644
index 0000000000..b949af81f6
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/14-footer.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/15-add-section.png b/docs/images/user/storefront/themes/theme-editor/15-add-section.png
new file mode 100644
index 0000000000..8d7fa93f4a
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/15-add-section.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/16-rearrange-sections.png b/docs/images/user/storefront/themes/theme-editor/16-rearrange-sections.png
new file mode 100644
index 0000000000..d29a90fd1a
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/16-rearrange-sections.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/17-delete-section.png b/docs/images/user/storefront/themes/theme-editor/17-delete-section.png
new file mode 100644
index 0000000000..e8d166a55b
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/17-delete-section.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/2-theme-editor.png b/docs/images/user/storefront/themes/theme-editor/2-theme-editor.png
new file mode 100644
index 0000000000..2050687985
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/2-theme-editor.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/3-top-navigation.png b/docs/images/user/storefront/themes/theme-editor/3-top-navigation.png
new file mode 100644
index 0000000000..b934d82bb7
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/3-top-navigation.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/4-page-selector.png b/docs/images/user/storefront/themes/theme-editor/4-page-selector.png
new file mode 100644
index 0000000000..380980ef97
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/4-page-selector.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/5-color-scheme.png b/docs/images/user/storefront/themes/theme-editor/5-color-scheme.png
new file mode 100644
index 0000000000..90e313fa3b
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/5-color-scheme.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/6-fonts.png b/docs/images/user/storefront/themes/theme-editor/6-fonts.png
new file mode 100644
index 0000000000..ef8327391d
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/6-fonts.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/7-views.png b/docs/images/user/storefront/themes/theme-editor/7-views.png
new file mode 100644
index 0000000000..c9bf36ed0f
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/7-views.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/8-side-navigation.png b/docs/images/user/storefront/themes/theme-editor/8-side-navigation.png
new file mode 100644
index 0000000000..bcd965fb76
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/8-side-navigation.png differ
diff --git a/docs/images/user/storefront/themes/theme-editor/9-page-sections.png b/docs/images/user/storefront/themes/theme-editor/9-page-sections.png
new file mode 100644
index 0000000000..bcb3f6a8a6
Binary files /dev/null and b/docs/images/user/storefront/themes/theme-editor/9-page-sections.png differ
diff --git a/docs/user/storefront/create-new-store.mdx b/docs/user/storefront/create-new-store.mdx
index e5228ba6ce..a4440c1b11 100644
--- a/docs/user/storefront/create-new-store.mdx
+++ b/docs/user/storefront/create-new-store.mdx
@@ -1,82 +1,76 @@
---
-title: 'Create a New Store'
-description: 'The multi-store functionality lets you manage separate brands or product lines from a single admin dashboard.'
+title: "Create a New Store"
+description: "Learn how to create and manage multiple stores in Spree Commerce."
---
-If you plan to target different customer segments, regions, or markets, you might want to add another store to offer tailored products and experiences. 
+Spree’s [<u>multi-store functionality</u>](https://spreecommerce.org/docs/use-case/multi-store/capabilities) allows you to manage completely separate storefronts - each with its own branding, products, payment methods, and more - all from a single admin dashboard.
-The multi-store approach also allows you to manage separate brands or product lines while keeping centralized control over operations and analytics.
+This is useful if you want to:
+- Target different customer segments or regions
+- Operate multiple brands or product lines
+- Offer localized shopping experiences
-To add a new store, click the site name in top left corner to reveal a dropdown menu and click “+ New Store”.
+## Add a New Store
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166756/docs/Storefront/Create%20a%20New%20Store/7.5.1_Create_a_New_Store_-_Add_New_Store_yjmzji.png)
+![How to create a new store in Spree Commerce](/docs/images/user/storefront/create-new-store/1-add-new-store.png)
-A window will appear that will allow you configure important settings for the creation of thew new store.
+1. Click **\+** next to your store name in the top-left corner of the admin dashboard.
+2. Select **New Store** from the dropdown.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166756/docs/Storefront/Create%20a%20New%20Store/7.5.2_Create_a_New_Store_-_Configure_Settings_rf543s.png)
+This opens a panel where you can configure the new store.
-There are five to be completed before creating the new store:
+### Required Settings
-* Site Name - the name that’s displayed in social sharing links, search engines, and browser tabs
+![Configuring new store settings in Spree Commerce](/docs/images/user/storefront/create-new-store/2-new-store-settings.png)
-* Country - the country you’ll be selling to
+You’ll be asked to fill in the following:
+- **Site Name** - the public-facing name of your store (used in social sharing and SEO)
+- **Country** - the country this store will serve
+- **Default locale** - the default language to be used on the store 
+- **Currency** - the currency used at checkout
+- **Import Products** - whether to import existing products from another store
+- **Import Payment Methods** - whether to import payment methods from another store
-* Currency - the currency you’ll be selling in
+<Note>Your choices should align with your business strategy. For example, if you're launching in a new region, you might use a different currency or pricing strategy but reuse your product catalog and payment setup.</Note>
-* Import Products - whether or not you’d like to import products from another store
+Once ready, click **Create** to launch your new store. You’ll be automatically redirected to its admin panel.
-* Import Payment Methods - whether or not you’d like to important payment methods from another store
+## Switch Between Stores
-Note: The country, currency, product imports, and payment methods you choose for your new store will depend on your specific use case and overall business model.
+![How to switch between stores in Spree Commerce](/docs/images/user/storefront/create-new-store/3-switch-stores.png)
-After configuring these settings, click the blue ‘Create’ button in the bottom right corner to create your new store. You will then be redirected to the store's admin panel.
-Congratulations, you’ve just created another store!
-
-## Switching Stores
-
-To switch between stores, click on the store name in the top left corner and select the store you’d like to manage.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166756/docs/Storefront/Create%20a%20New%20Store/7.5.3_Create_a_New_Store_-_Switching_Stores_bsuzzn.png)
+To manage a different store, click the **store name** in the top-left corner and select the store you want to access.
## Cross-Store Data Sharing
-Here’s a breakdown of what will and will not be shared with the new store, as shown in the new store settings window.
-
-### What will be shared with the new store
-
-* Products, Locations & Inventory
-
- * you can select which ones will be available for this store
-
-* Customers
-
-* Shipping methods, rates and markets
-
-* Payment Methods
-
- * you can select which ones will be available for this store
-
-* Admin user privileges
-
-### &#xA;What will not be shared with the new store
-
-* Orders
-
-* Shipments
-
-* Payments
-
-* Refunds
+When creating a new store, Spree gives you control over what data is shared and what remains separate.
-* Store Credits
+### Shared with New Store
+- **Products, Inventory & Locations** (can choose which apply to this store)
+- **Customers**
+- **Shipping Methods, Rates, Markets**
+- **Payment Methods** (selectable per store)
+- **Admin User Access**
-* Gift cards
+### Not Shared with New Store
+- Orders
+- Shipments
+- Payments
+- Refunds
+- Store Credits
+- Gift Cards
+- Blog Posts
+- Themes & Pages
+- Integrations (e.g., Google Analytics, Meta Pixel)
-* Blogs Posts
+## Next Steps
-* Themes & Pages
+Once your new store is created, you can:
-* Integrations eg. Google Analytics, Meta Pixel, etc.
+- [<u>Customize the storefront theme</u>](https://spreecommerce.org/docs/user/storefront/theme-editor)
+- [<u>Set up store-specific promotions</u>](https://spreecommerce.org/docs/user/promotions/create-a-promotion)
+- [<u>Manage localized shipping and tax settings</u>](https://spreecommerce.org/docs/user/settings/zones)
+- [<u>Import or manage your product catalog</u>](https://spreecommerce.org/docs/user/manage-products/import-products)
-For more information about multi-store management, please refer to another support article.
\ No newline at end of file
+Interested to learn more? Check out our [<u>Multi-Store use case article</u>](https://spreecommerce.org/docs/use-case/multi-store/model).
diff --git a/docs/user/storefront/create-new-theme.mdx b/docs/user/storefront/create-new-theme.mdx
index 332b07d20e..066114567b 100644
--- a/docs/user/storefront/create-new-theme.mdx
+++ b/docs/user/storefront/create-new-theme.mdx
@@ -1,50 +1,50 @@
---
title: "Create & Publish a New Theme"
-description: "Create a New Theme for your store running on Spree Commerce open-source and manage it in a drag & drop editor without involving developers."
+description: "Learn how to create and publish new themes in Spree Commerce."
---
-Spree open-source supports multiple storefront themes, giving you the flexibility to design and customize your eCommerce experience with no developers involved (no-code) and without disrupting your live store. 
+Spree Commerce supports multiple storefront themes, allowing you to design and manage your storefront visually - without writing code or disrupting your live site.
-While only one theme can be live at a time, you can seamlessly switch between themes with just a click. This allows you to experiment, update, or prepare new designs in the background.
+While only one theme can be live at a time, you can freely create, duplicate, and edit themes in the background, switching them live whenever you’re ready.
## Create a New Theme
-To create a new theme, navigate to the Storefront tab of the admin dashboard.
+Navigate to the **Storefront** tab in the admin dashboard to view your list of themes. 
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Create%20Themes/7.1.2.1_Create_Publish_Themes_-_Navigate_To_Tab_cn3s04.png)
+![Creating a new storefront theme in Spree Commerce](/docs/images/user/storefront/themes/create-new-theme/1-themes-tab.png)
-Here, you’ll find two options to create a new theme.
+You have two options to create a new one:
-### Duplicate an Existing Theme
+### Clone an Existing Theme
-If you don’t want to create a new theme from scratch, you can create an exact copy of an existing theme by duplicating it.
+![Cloning an existing storefront theme in Spree Commerce](/docs/images/user/storefront/themes/create-new-theme/2-clone-theme.png)
-To duplicate a theme, find the theme you’d like to copy, click the three dots on the right hand side, and select Duplicate.
+If you want to build off an existing layout or design, click the three dots next to the theme you want to copy and select **Clone**.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Create%20Themes/7.1.2.2_Create_Publish_Themes_-_Duplicate_A_Theme_bk01qy.png)
+The clone will appear in your list of themes as a Draft, ready to edit without impacting the live storefront.
-The duplicate will be added to your list of themes and can now be updated and experimented with without affecting the live storefront.
+### Start from a Template
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Create%20Themes/7.1.2.3_Create_Publish_Themes_-_Duplicate_Added_lilczu.png)
+![Choosing a starter storefront theme template in Spree Commerce](/docs/images/user/storefront/themes/create-new-theme/3-starter-theme.png)
-### Add a New Theme
+Scroll to the bottom of the themes list and choose from one of the available starter templates.
-If you’d rather start with an empty template, then you can add a new theme by selecting one of the theme templates at the bottom of the page.
+Click **Add**, and the new theme will be added to your theme list as a Draft.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Create%20Themes/7.1.2.4_Create_Publish_Themes_-_Add_a_New_Theme_qdetx9.png)
+## Edit Your Theme
-Simply click the blue “Add” button and the theme will be to your list of themes and can now be updated and experimented with without affecting the live storefront.
+Simply click on any theme in **Draft** status to open the visual page builder. You can update layouts, change styling, and preview changes in real time.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Create%20Themes/7.1.2.5_Create_Publish_Themes_-_New_Theme_Added_r9tlkz.png)
+Refer to the [<u>Theme Editor</u>](https://spreecommerce.org/docs/user/storefront/theme-editor) documentation for full details on editing themes.
## Publish a Theme
-Once you’re happy with the layout design of your new theme, you’ll probably want to publish it at some point.
+![Publishing a new storefront theme in Spree Commerce](/docs/images/user/storefront/themes/create-new-theme/4-publish-theme.png)
-You can publish a theme at any time by clicking the “Publish” button on the right hand side.
+When you're ready to go live with a new theme:
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Create%20Themes/7.1.2.6_Create_Publish_Themes_-_Publish_A_Theme_nh6926.png)
+- Click the **Publish** button next to the theme.
+- The newly published theme will be marked as **Live**.
+- The previously live theme will automatically revert to **Draft**.
-You’ll notice that the status of the theme you published will change to ‘Live’ and the previously live theme will change to ‘Draft’.
-
-Note: Only one theme can be live at any given time.
\ No newline at end of file
+<Note>Only one theme can be live at a time.</Note>
diff --git a/docs/user/storefront/delete-theme.mdx b/docs/user/storefront/delete-theme.mdx
index 5cef6e9186..e3cefc4156 100644
--- a/docs/user/storefront/delete-theme.mdx
+++ b/docs/user/storefront/delete-theme.mdx
@@ -1,10 +1,17 @@
---
title: "Delete a Theme"
-description: "Delete a Theme and manage your storefront without any developer help."
+description: "Learn how to delete a storefront theme in Spree Commerce."
---
-If, for any reason, you wish to delete a theme, simply navigate to the Storefront tab of the admin dashboard, click the three dots on the right hand side of the theme you wish to delete, and select ‘Delete’ from the dropdown.
+If you need to remove a theme from your store - for example, to clean up unused drafts or simplify theme management - you can do so easily from the Spree dashboard.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166763/docs/Storefront/Delete%20A%20Theme/7.1.3_Delete_A_Theme_h4h4of.png)
+### How to Delete a Theme
-Note: Only ‘Draft’ themes can be deleted.
\ No newline at end of file
+![Deleting a storefront theme in Spree Commerce](/docs/images/user/storefront/themes/delete-theme/1-theme-deletion.png)
+
+1. Navigate to the **Storefront** tab of the admin dashboard.
+2. Locate the theme you want to delete.
+3. Click the three-dot menu (`⋯`) on the right-hand side of the theme card.
+4. Select **Delete** from the dropdown menu.
+
+<Note>Only **Draft** themes can be deleted. Published themes must be unpublished or replaced before they can be removed.</Note>
diff --git a/docs/user/storefront/theme-editor.mdx b/docs/user/storefront/theme-editor.mdx
index d0cba2285f..cb755fddb0 100644
--- a/docs/user/storefront/theme-editor.mdx
+++ b/docs/user/storefront/theme-editor.mdx
@@ -1,300 +1,194 @@
---
title: "Theme Editor"
-description: "Spree Commerce drag & drop theme editor enabling your team to design, preview, and publish storefront changes without involving developers - without code deployments."
+description: "Learn how to use the Theme Editor to customize your storefront in Spree Commerce."
---
-A visually appealing and well-organized storefront is essential for any online business. It builds trust with customers and can significantly improve your conversion rates. 
+A visually appealing and well-organized storefront is essential for any online business. It builds trust with customers and can significantly improve your conversion rates.
-The intuitive Spree theme editor features a drag-and-drop page builder that allows you to create professional storefronts that reflect your brand identity, all without writing code or hiring developers. 
+The Spree theme editor provides a powerful, no-code, drag-and-drop page builder that allows you to visually design your storefront, reflect your brand identity, and preview changes in real time - without writing a single line of code or hiring developers.
-The visual interface allows you to design, preview, and publish changes in real-time.
+## How to Edit Your Theme
-To edit the theme of your storefront, first navigate to the Themes tab of the admin dashboard found under Storefront.
+To edit your storefront’s theme, navigate to **Storefront → Themes** in the admin dashboard.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.1_Theme_Editor_-_Navigate_to_Tab_dyt7i4.png)
+![Managing storefront themes in Spree Commerce](/docs/images/user/storefront/themes/theme-editor/1-themes-tab.png)
-Locate the ‘Default’ theme with status ‘Live’ and click on it.
+Find the theme with the status **Live** and click on it to open the theme editor.
-Doing so will open the page builder interface where you can begin modifying the layout of your storefront.
+![The Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/2-theme-editor.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.2_Theme_Editor_-_Click_On_Default_Theme_qy0urp.png)
+<Warning>It’s useful to note before we go further that you should always click **Publish** in the top-right corner to save your changes. Leaving the editor without publishing will discard all unsaved edits.</Warning>
-Please Note: Whenever you make changes that you’d like to keep, make sure to click the blue ‘Publish’ button in the the top right corner, otherwise you will lose all changes if you navigate away from the page builder.
+Let’s walk through the different areas of the page builder.
-Let’s now take a look at all the different elements of the page builder in detail.
+## Top Navigation
-## Top Bar
+![The top navigation bar in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/3-top-navigation.png)
-In top bar, you can select which page to work on, set global theme settings, and switch between editor views.
+The top navigation bar allows you to switch between pages, adjust global settings, and preview different views of the storefront. 
-### Views
-
-In the top right corner next to the ‘Publish’ button, there are 3 buttons.
-
-#### Mobile View
-
-Clicking on the mobile icon will change the page builder preview to a mobile layout
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.3_Theme_Editor_-_Mobile_View_rrfeza.png)
-
-Note: The storefront and all prebuilt page elements are mobile friendly by default.
-
-#### Desktop View
-
-Clicking on the desktop icon will switch the page builder preview to a desktop layout.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.4_Theme_Editor_-_Desktop_View_otjdmn.png)
-
-#### Preview
-
-Clicking on the preview button will allow you to see a preview of the live site, i.e., outside of the page builder. This allows you to see an accurate representation of what the storefront will look like before publishing any changes.
+This gives you access to the following controls and settings:
### Page Selector
-In the top left corner of the screen, there’s a dropdwon menu that allows you to select the page you’d like to work on.
+![The page selector in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/4-page-selector.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.5_Theme_Editor_-_Page_Selector_ii5ry2.png)
-
-Simply select the page you’d like to work on and the page builder preview and side bar will change to reflect the selection.
+In the top-left dropdown, choose which page you want to edit. The editor will reload with the selected page's layout and elements.
### Color Scheme
-To change the color scheme of your storefront, click on the color palette icon next to the page selector. Doing so will cause the side bar UI to show a list of page elements and they’re default colors.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.6_Theme_Editor_-_Color_Scheme_cvogat.png)
+![Modifying color schemes in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/5-color-scheme.png)
-To change the global color of an element, click on the colored circle next to the element you wish to change.
+Click the **palette icon** to open the global color settings. You can change the default colors used across all pages.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.7_Theme_Editor_-_Color_Editor_iedflt.png)
-
-This opens a color editor popup that allows you to either enter the color code at the bottom, or manually shift the pointer and sliders around until you find the desired color.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.8_Theme_Editor_-_Edit_The_Color_sz7odm.png)
-
-Note: The slider on the far right of the color editor adjusts transparency.
+Click any colored circle to open the color editor, where you can:
+- Enter a hex code manually
+- Adjust the hue and saturation
+- Control transparency using the right-hand slider
### Fonts
-To change storefront fonts, click on the letter A next to the color palette icon. Doing so will change the side bar UI to a font selector interface.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.9_Theme_Editor_-_Fonts_uptm9z.png)
+![Setting fonts in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/6-fonts.png)
-#### Standard Fonts
+Click the **A icon** to change fonts. You can choose from:
+- **Standard Fonts** - Select separate font families and sizes for body text and headings using dropdowns and sliders.
+- **Custom Fonts** - Add custom fonts by pasting the embed and style code.
-In the first tab, you can apply different font families to normal text and headers by selecting them from the respective dropdown menus.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.10_Theme_Editor_-_Standard_Fonts_g44ks6.png)
-
-You can also set the size of text and headers by adjusting the respective size scale sliders.
-
-#### Custom Fonts
-
-In the second tab, you can add custom fonts by inserting the code into the box, e.g.:
+### Views
-```html
-<link rel="stylesheet" href="https://url.to.your.font.com/font.js" />
-<style>
- /* set font for body */
- body {
- font-family: "your font name", sans-serif;
- }
- /* set font for headings */
- h1, h2, h3, h4, h5, h6 {
- font-family: "your font name", sans-serif;
- }
-</style>
-```
+![Switch between mobile and desktop preview in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/7-views.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.11_Theme_Editor_-_Custom_Fonts_hk0pju.png)
+Located in the middle of the 
+- **Mobile View** - Preview how the storefront looks on mobile devices.__
+- **Desktop View** - Preview how the storefront looks on desktop desktop devices.
-## Side Bar
+## Side Navigation
-In the side bar, you can add, edit, and rearrange the sections and elements of the page you are working on.
+![The side navigation bar in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/8-side-navigation.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.12_Theme_Editor_-_Side_Bar_nbvfpf.png)
+The side navigation allows you to add, configure, and arrange page sections and individual content blocks.
### Page Section Settings
-Most of the page sections and page elements display two different settings tabs when clicked on. Different page sections have different settings for both content and design.
-
-#### Content Settings
-
-In the content tab, you can edit the content of that particular section, such as text, images, and links.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.13_Theme_Editor_-_Content_Settings_jo7fjj.png)
-
-#### Design Settings
+![Configuring page section settings in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/9-page-sections.png)
-In the design tab, you can modify color, padding, borders, alignment, and in some cases section layout.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.14_Theme_Editor_-_Design_Settings_o9ke0l.png)
+Click on any page section or element to configure its content and appearance. Most page sections have two distinct tabs:
+- **Content Settings** - Edit text, links, images, and other content 
+- **Design Settings** - Change padding, borders, alignment, color, and sometimes layouts
### Global Page Sections
-Global page sections are visible on all pages of your website, and any changes made to them on one page will be reflected on all other pages.
+Global sections appear across every page (besides checkout) and update everywhere when edited. Global page sections are as follows:
#### Announcement Bar
-The announcement bar is a global page section that can display an important message across your entire website, and is situated at the very top of the page.
-
-For example, you could use it to inform visitors about the latest promos or free shipping.
+![Configuring the announcement bar in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/10-announcement-bar.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.15_Theme_Editor_-_Announcement_Bar_bfjdhd.png)
-
-In the above example, we changed the text, made it bold, and set the background color to #E8E811.
+Add a message that appears at the very top of every page. Ideal for welcome messages and promos like free shipping or limited-time discounts.
#### Page Header
-The header serves as your store's navigation hub and first point of interaction, housing essential elements like your logo, menu categories, search bar, shopping cart, and user account access. 
-
-As the most visible and consistent element across all pages, it shapes your brand's first impression while ensuring customers can easily find what they need and complete their purchases, directly impacting your conversion rates.
-
-#### Logo
-
-You can add your logo by clicking on ‘Header’ and selecting the file you wish to upload.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.16_Theme_Editor_-_Logo_dlwofg.png)
-
-You can adjust the size of the logo, as well as other header design settings, in the design tab.
+![Configuring the header in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/11-page-header.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.17_Theme_Editor_-_Adjust_Logo_dh3nre.png)
+The header includes your:
-#### Links
+- Logo
+- Navigation links
+- Search bar
+- Cart icon
+- Account menu
-If you’re using the default header configuration, then you can add links to the header by clicking on ‘Header’ and clicking on ‘+ Add Link’.
+##### Add Logo
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.18_Theme_Editor_-_Add_Links_vsufgw.png)
+Click **Header** and upload your logo. You can resize its presentation in the **Design** tab.
-This will open up a link configuration menu that allows you to set the type of link, where it should point to, and the name it should be presented with.
+##### Add Links
-Link types are as follows:
+Click **Add Link** to add navigation items.
-* Page - static pages, e.g., Shop All, Homepage, About Us, Blog, etc.
+Link Types are as follows:
+- Page (e.g. About Us, Blog)
+- Product
+- Post (blog)
+- Taxon (category)
+- Policy (e.g. Terms)
+- URL (external or internal)
-* Product - an individual product page
+You can also choose to have the link open in a new tab.
-* Post - an individual blog post
+##### Add Blocks
-* Taxon - a product listing page for a taxon, e.g., Fashion, Garden
+![Adding blocks to the header in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/12-add-blocks.png)
-* Policy - one of your store policies, e.g., Terms and Conditions, Privacy Policy, etc.
-
-* URL - a URL that links to an internal or external page
-
-You can also choose whether or not to have the link open in a new tab.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.19_Theme_Editor_-_Configure_Link_uvglmp.png)
-
-In the above example, we chose to add a link to the ‘Categories -> Fashion’ taxon that does not open in a new tab.
-
-#### Custom Header Configuration
-
-Under ‘Header’ in the page builder side bar, there is an option to ‘+ Add Block’.
-
-Clicking on this will allow you to configure a custom header with more advanced functionality instead of only simple links.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.20_Theme_Editor_-_Custom_Header_att0fo.png)
-
-There are 3 options to choose from. Link is the same as described above, but let’s take a closer look at the other two options.
-
-#### *Mega Nav With Subcategories*
-
-This block allows you add a dropdown menu to your header that appears when hovering over that item in the header.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.21_Theme_Editor_-_Mega_Nav_With_Subcategories_cylpgl.png)
-
-Simply select a taxon, and the mega nav will be automatically populated with all subtaxons nested below it.
-
-You can also choose to include a ‘Featured Taxon’ which will add a link to that taxon along with its images on the right hand side of the mega nav. This adds to the aesthetic appeal of your website.
-
-#### *Mega Nav*
-
-This block functions in the same way as the ‘Mega Nav With Subcategories’ block, except you decided which links to include in which columns.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.22_Theme_Editor_-_Mega_Nav_frslyv.png)
-
-Simply add links as previously shown and they’ll be added to the mega nav dropdown.
+Click **Add Block** to configure a more advanced header layout. You can select from the following block types:
+- **Mega Nav with Subcategories** - Add a dropdown menu populated from a chosen taxon and its subtaxons. Optionally feature a highlighted taxon with image.
+- **Mega Nav** - Manually add links to columns within a dropdown layout for full control over structure.
+- **Link** - A simple link to taxon, product, policy or any other page.
#### Newsletter
-The newsletter is another global page section that allows you to capture user email addresses without them having to place an order.
-
-It enables you to build a direct marketing channel with your customers, allowing you to share new products, promotions, and content that drive first-time or repeat purchases and increases customer lifetime value.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.23_Theme_Editor_-_Newsletter_kbadpz.png)
+![Configuring the newsletter sections in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/13-newsletter.png)
-You can edit the content in the newsletter section by clicking on the individual elements in the side bar and modifying the text.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.24_Theme_Editor_-_Edit_Newsletter_ujigku.png)
+A global email capture section to build your subscriber list. Customize text and styling as needed.
#### Footer
-The footer serves as a trust-building section of your store by housing essential business information, policies, and links to key pages – giving customers the confidence and resources they need to make informed purchasing decisions.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.25_Theme_Editor_-_Footer_onoljc.png)
+![Configuring the footer section in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/14-footer.png)
-Similar to the header, you can add your logo (whether it be the same or different from the header logo).
+Add:
+- Your logo
+- Policy links
+- Product category links
+- Social media links
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.26_Theme_Editor_-_Footer_Logo_fmpbk5.png)
-
-Adding blocks to the footer will add new sections wherein you can nest links.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.27_Theme_Editor_-_Footer_Blocks_y6kvmr.png)
-
-Links are added to blocks in the same way as described in the ‘Header’ section of this support article.
+Organize content into blocks using **Add Block**, and add links as you did in the Header section.
### Page-Specific Sections
-As the name suggests, these sections are specific to whichever page you add them to, and allow you to create an interesting, visually appealing storefront experience that helps your customers discover new products and categories, and learn more about your business.
+These only appear on the page they’re added to - ideal for storytelling, product discovery, and homepage content.
#### Add Page Sections
-To add a page section, click the blue ‘Add Section’ button in the side bar.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.28_Theme_Editor_-_Add_Page_Sections_ksxhs1.png)
+![Adding more pages section in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/15-add-section.png)
-This will open a menu that allows you to select the type of page section you’d like to add.
+Click **Add Section** in the sidebar, then choose a layout type from the following options:
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.29_Theme_Editor_-_Page_Section_Menu_rijc9l.png)
+- Breadcrumbs
+- Custom Code
+- Featured Posts
+- Featured Product
+- Featured Taxon
+- Featured Taxons
+- Image Banner
+- Image With Text
+- Page Title
+- Related Products
+- Rich Text
+- Video
-Simply select the page you want to add and the blank section template will be added to the bottom of the page (but above the newsletter and footer sections).
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.30_Theme_Editor_-_Choose_Page_Section_npa7f9.png)
-
-In this example, we chose a Image Banner page section, which display a page-width image along with optional header, text, and button elements.
+The newly added section will appear at the bottom of the page, but above the footer and newsletter.
#### Edit Page Sections and Elements
-To edit a page section or element, either select it from the side bar, or click on it in editor preview. This will open up the settings for that particular section or element.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.31_Theme_Editor_-_Edit_Sections_And_Elements_chwcd8.png)
-
-Simply update the content field or design settings to have them reflected in the the editor preview.
-
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.32_Theme_Editor_-_Update_Fields_b8ldzy.png)
-
-In this example, we added an image, change the header content, and made all of the text bold.
-
-#### Delete Page Sections and Elements
-
-To delete a page section or element, simple select it from the side bar or click on it in the editor preview, and locate the ‘Delete button in the bottom left corner of the page.
+Click on a section in the sidebar or directly in the preview to update content or design. All changes reflect immediately in the editor preview.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.33_Theme_Editor_-_Edited_Section_Example_cyuuzr.png)
+#### Rearrange Page Sections and Elements
-Click ‘Delete’ and the chosen section or element will be removed from the page.
+![Rearranging page sections in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/16-rearrange-sections.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.34_Theme_Editor_-_Delete_Button_aal2ce.png)
+To move a page section or element, hover over it in the preview to reveal the actions menu, then use the up and down arrows to reposition it to the desired location on the page.
-In this example, we deleted the text element from the image banner section.
+#### Delete Sections and Elements
-You can also delete sections and elements by hovering over them in the page editor, and clicking on the blue trashcan button.
+![Deleting page sections in the Spree Commerce theme editor](/docs/images/user/storefront/themes/theme-editor/17-delete-section.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166777/docs/Storefront/Theme%20Editor/7.1.1.1.35_Theme_Editor_-_Element_Deleted_c0dy8u.png)
+You can either:
-For more information about the different pre-built page sections available in Spree and how to configure them, please refer to another support article.
+- Select a section and click **Delete** at the bottom left of the side navigation
+- Hover over an element in the preview and click the trash can icon
## Publish
-Once you’re happy with all of the changes you’ve made, make sure to hit the blue ‘Publish’ button in the top right hand corner to save and publish your changes, otherwise you’ll lose all of your progress if you navigate away from the page editor.
+Once you’re finished modifying your storefront theme, click **Publish** in the top right corner to save and apply your changes to the live storefront immediately.
-After publishing, all changes will be reflected immediately on the live storefront.
\ No newline at end of file
+<Warning>Any changes you make in the editor are **not saved** until you click **Publish**. If you do not wish to save your changes, simply back out of the theme editor.</Warning>