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.

Updated 'Pages' user documentation (#13316)

jaburghesc524f049120c
diff --git a/docs/images/user/storefront/pages/create-a-page/1-create-landing-page.png b/docs/images/user/storefront/pages/create-a-page/1-create-landing-page.png
new file mode 100644
index 0000000000..ec81c22771
Binary files /dev/null and b/docs/images/user/storefront/pages/create-a-page/1-create-landing-page.png differ
diff --git a/docs/images/user/storefront/pages/create-a-page/2-enter-page-name.png b/docs/images/user/storefront/pages/create-a-page/2-enter-page-name.png
new file mode 100644
index 0000000000..2cbf62e8cd
Binary files /dev/null and b/docs/images/user/storefront/pages/create-a-page/2-enter-page-name.png differ
diff --git a/docs/images/user/storefront/pages/create-a-page/3-theme-editor.png b/docs/images/user/storefront/pages/create-a-page/3-theme-editor.png
new file mode 100644
index 0000000000..3066c4eec6
Binary files /dev/null and b/docs/images/user/storefront/pages/create-a-page/3-theme-editor.png differ
diff --git a/docs/images/user/storefront/pages/delete-a-page/1-delete-landing-page.png b/docs/images/user/storefront/pages/delete-a-page/1-delete-landing-page.png
new file mode 100644
index 0000000000..5e8d831ed8
Binary files /dev/null and b/docs/images/user/storefront/pages/delete-a-page/1-delete-landing-page.png differ
diff --git a/docs/images/user/storefront/pages/delete-a-page/2-select-delete.png b/docs/images/user/storefront/pages/delete-a-page/2-select-delete.png
new file mode 100644
index 0000000000..c97572b2f2
Binary files /dev/null and b/docs/images/user/storefront/pages/delete-a-page/2-select-delete.png differ
diff --git a/docs/images/user/storefront/pages/edit-a-page/1-edit-landing-page.png b/docs/images/user/storefront/pages/edit-a-page/1-edit-landing-page.png
new file mode 100644
index 0000000000..c39c855376
Binary files /dev/null and b/docs/images/user/storefront/pages/edit-a-page/1-edit-landing-page.png differ
diff --git a/docs/images/user/storefront/pages/edit-a-page/2-theme-editor.png b/docs/images/user/storefront/pages/edit-a-page/2-theme-editor.png
new file mode 100644
index 0000000000..8daf77b174
Binary files /dev/null and b/docs/images/user/storefront/pages/edit-a-page/2-theme-editor.png differ
diff --git a/docs/images/user/storefront/pages/edit-a-page/3-page-settings.png b/docs/images/user/storefront/pages/edit-a-page/3-page-settings.png
new file mode 100644
index 0000000000..52a5f1c25e
Binary files /dev/null and b/docs/images/user/storefront/pages/edit-a-page/3-page-settings.png differ
diff --git a/docs/images/user/storefront/pages/edit-a-page/4-settings-window.png b/docs/images/user/storefront/pages/edit-a-page/4-settings-window.png
new file mode 100644
index 0000000000..d8def53592
Binary files /dev/null and b/docs/images/user/storefront/pages/edit-a-page/4-settings-window.png differ
diff --git a/docs/user/storefront/create-page.mdx b/docs/user/storefront/create-page.mdx
index 012900a531..e75509fc73 100644
--- a/docs/user/storefront/create-page.mdx
+++ b/docs/user/storefront/create-page.mdx
@@ -1,24 +1,38 @@
---
-description: "Add product-focused landing pages or content pages to your store, such as an About Us page, and manage their content without any developer help."
title: "Create a Landing Page"
+description: "Learn how to create new pages in Spree Commerce."
---
-Besides the automatically generated pages like the PDPs, PLPs, and policies, Spree makes it easy to add custom pages to your store, such as an About Us page or product-focused landing pages.
+You can add custom pages to your store - such as an About Us page, a brand story page, or product-focused landing pages - without any developer assistance. These pages let you share additional content with your customers and highlight what matters most to your brand.
-Using these pages can give you more ways to engage your audience and tell your brand story, helping you tailor your store's content to better connect with your customers and highlight what matters most.
+Although core pages like Product Details Pages (PDPs), Product Listing Pages (PLPs), and policy pages are generated automatically, Spree allows you to create as many additional pages as your store needs.
-To add a new page, navigate to the Pages tab of the admin dashboard found under Storefront.
+## Create a New Page
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166756/docs/Storefront/Create%20a%20Page/7.2.1.1_Create_a_Page_-_Navigate_To_Tab_lcvqmj.png)
+To create a new page, go to **Storefront → Pages** in the admin dashboard.
-Then, click on the blue “Add New Page” button in the top right corner. This will redirect you to the page creation page where you simply need to enter the name of the new page to proceed.
+![Pages tab in the Spree Commerce admin dashboard](/docs/images/user/storefront/pages/create-a-page/1-create-landing-page.png)
-Note: You can also edit the SEO settings for the new page at this time, but you can also do it later after the page has been created.
+Click **Add New Page** in the top-right corner and enter a name for your new page in the form.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166756/docs/Storefront/Create%20a%20Page/7.2.1.2_Create_a_Page_-_Page_Creation_f14jvc.png)
+<Note>Optional: Adjust the SEO settings before creating the page.</Note>
-After naming and clicking ‘Create’, you’ll be redirected to the Theme Editor where you can begin customizing the newly created page.
+![Page creation form in the Spree Commerce](/docs/images/user/storefront/pages/create-a-page/2-enter-page-name.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/v1738166757/docs/Storefront/Create%20a%20Page/7.2.1.3_Create_a_Page_-_Page_Created_qqdtf3.png)
+Click **Create** to finalize the creation of your new page and you'll be redirected to the [<u>Theme Editor</u>](https://spreecommerce.org/docs/user/storefront/theme-editor), where you can begin customizing its layout and content.
-For more information about using the Theme Editor to customize your page, please refer to this support article.
\ No newline at end of file
+## Customize Your Page
+
+![A new page in the Spree Commerce theme editor](/docs/images/user/storefront/pages/create-a-page/3-theme-editor.png)
+
+Once inside the Theme Editor, you can:
+
+- Add, remove, and reorder page sections
+- Insert images, text, banners, links, and more
+- Adjust design settings
+- Preview your changes in mobile and desktop views
+- Click **Publish** when ready to save your changes
+
+After you publish the page, it becomes immediately available on your live storefront. You can link to it in your navigation menu and other storefront sections, or use it in marketing campaigns.
+
+For detailed instructions on working with the Theme Editor, please refer to our [<u>Theme Editor documentation</u>](https://spreecommerce.org/docs/user/storefront/theme-editor).
diff --git a/docs/user/storefront/delete-page.mdx b/docs/user/storefront/delete-page.mdx
index 7ea57ca852..2c55748572 100644
--- a/docs/user/storefront/delete-page.mdx
+++ b/docs/user/storefront/delete-page.mdx
@@ -1,24 +1,22 @@
---
title: "Delete a Landing Page"
-description: "Delete a landing page you no longer need."
+description: "Learn how to delete custom pages in Spree Commerce."
---
-When a page is no longer needed, you can remove it to keep your backend organized and clutter-free.
+# Delete a Landing Page
-To delete a page, navigate to the Pages tab of the admin dashboard, found under Storefront.
+If a landing page is no longer needed, you can delete it directly from the Pages list to keep your admin area organized.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Delete%20a%20Page/7.2.3.1_Delete_a_Page_-_Navigate_To_Tab_hkodjz.png)
+## Delete a Page
-Find the page you want to delete and click on it. This will open the Theme Editor for that specific page.
+To delete a page, go to **Storefront → Pages** in the admin dashboard, and find the page you want to remove.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Delete%20a%20Page/7.2.3.2_Delete_a_Page_-_Click_On_Page_nuwlxn.png)
+![How to delete a page in Spree Commerce](/docs/images/user/storefront/pages/delete-a-page/1-delete-landing-page.png)
-Click on ‘Page Settings’ found on the right hand side of the top bar Theme Editor. This will open the page settings window.
+Click the **three-dot menu** on the right side of the page row.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Delete%20a%20Page/7.2.3.3_Delete_a_Page_-_Page_Settings_labnbn.png)
+![Deleting a custom page in Spree Commerce](/docs/images/user/storefront/pages/delete-a-page/2-select-delete.png)
-Click the red ‘Delete’ button and the page will be removed from your website.
+Then simply select **Delete** and confirm the deletion when prompted.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Delete%20a%20Page/7.2.3.4_Delete_a_Page_-_Click_Delete_isenmq.png)
-
-Congratulations, you just de-cluttered your website!
\ No newline at end of file
+The page will be removed immediately and will no longer appear on your storefront.
diff --git a/docs/user/storefront/edit-page.mdx b/docs/user/storefront/edit-page.mdx
index 2bab47c3a8..0192911074 100644
--- a/docs/user/storefront/edit-page.mdx
+++ b/docs/user/storefront/edit-page.mdx
@@ -1,34 +1,53 @@
---
-title: 'Edit a Landing Page'
-description: 'Update the products or content on your custom landing pages without any developer help'
+title: "Edit a Landing Page"
+description: "Learn how to edit custom landing pages in Spree Commerce."
---
-From time to time, you may find it necessary to update the products or information that's displayed on your custom pages, perhaps even the layout itself.
+# Edit a Landing Page
-To edit a page, navigate to the Pages tab of the admin dashboard, found under Storefront.
+Learn how to edit custom landing pages in Spree Commerce.
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Edit%20a%20Page/7.2.2.1_Edit_a_Page_-_Navigate_To_Tab_tow3np.png)
+You can easily update the content, layout, or product sections on your custom landing pages directly through the Theme Editor - no developer help required.
-Locate the page you’d like to edit and click on it. This will open up the Theme Editor for that specific page.
+## Edit a Page
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Edit%20a%20Page/7.2.2.2_Edit_a_Page_-_Click_On_The_Page_guboul.png)
+To edit a page, go to **Storefront → Pages** in the admin dashboard.
-Here you can modify the page as you would with any other page in the Theme Editor as described in this support article: \{\{LINK TO THEME EDITOR}}
+![Edit a custom page in Spree Commerce](/docs/images/user/storefront/pages/edit-a-page/1-edit-landing-page.png)
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Edit%20a%20Page/7.2.2.3_Edit_a_Page_-_Page_Edited_s7cgcc.png)
+Find the page you want to edit and click on it and you’ll be taken to the [<u>Theme Editor</u>](https://spreecommerce.org/docs/user/storefront/theme-editor) for that specific page.
-Important: Make sure to click ‘Publish’ once you’re done editing the page, otherwise any changes you’ve made will not be saved when you navigate away from the Theme Editor.
+![Editing a page in the Spree Commerce theme editor](/docs/images/user/storefront/pages/edit-a-page/2-theme-editor.png)
-## Page Settings
+From here, you can update the page just like any other customizable page in the Theme Editor.
-In the top bar of the Theme Editor, you’ll notice the ‘Page Settings’ button. 
+## Make Changes in the Theme Editor
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Edit%20a%20Page/7.2.2.4_Edit_a_Page_-_Page_Settings_a35xwj.png)
+Inside the Theme Editor, you can:
-Clicking on this will open up a window that allows you to change the page name, meta title and description, and the URL slug. There is also an option to delete the page.
+- Add, remove, or reorder page sections
+- Update images, text, and other content
+- Adjust design settings
+- Preview your changes on mobile and desktop
+- **Publish** your updates when ready
-![](https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1738166762/docs/Storefront/Edit%20a%20Page/7.2.2.5_Edit_a_Page_-_Page_Settings_Window_kb1pwu.png)
+<Warning>Be sure to click **Publish** when you're finished, otherwise your changes will not be saved or published to the live site.</Warning>
-Simply edit the information as required and click the blue ‘Save’ button at the bottom of the window.
+For more information on how to work with the Theme Editor, please refer to our [<u>Theme Editor documentation</u>](https://spreecommerce.org/docs/user/storefront/theme-editor).
-For more information about creating pages, please refer to this support article.
\ No newline at end of file
+## Edit Page Settings
+
+![Modifying page settings in Spree Commerce](/docs/images/user/storefront/pages/edit-a-page/3-page-settings.png)
+
+In the top-left corner of the Theme Editor, click **Settings** to open up settings window.
+
+![Page settings window in Spree theme editor](/docs/images/user/storefront/pages/edit-a-page/4-settings-window.png)
+
+Here you can edit:
+
+- Page name
+- Meta title
+- Meta description
+- URL slug
+
+You can also delete the page from this window if needed. After making updates, click **Save**.