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.

Storefront user docs (#12378)

mintlify[bot]ce25a6b1073d
diff --git a/docs/user/storefront/create-new-store.mdx b/docs/user/storefront/create-new-store.mdx
new file mode 100644
index 0000000000..fabdeb9bbf
--- /dev/null
+++ b/docs/user/storefront/create-new-store.mdx
@@ -0,0 +1,82 @@
+---
+title: 'Create a New Store'
+description: 'The multi-store functionality lets you manage separate brands or product lines from a single admin dashboard.'
+---
+
+If you plan to target different customer segments, regions, or markets, you might want to add another store to offer tailored products and experiences. 
+
+The multi-store approach also allows you to manage separate brands or product lines while keeping centralized control over operations and analytics.
+
+To add a new store, click the site name in top left corner to reveal a dropdown menu and click “+ New Store”.
+
+<img height="371" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfipX2PiRp_6HnnHrsQJpEJQln59IpHbFmAdh2qPLQv0wM79d-vgboD5NvYlvwkgF5XWTe6p3UTneEioFy-WCcm3edwJ0dtmTnedv35F6zYC-pdY_X_3ax8FK3q8bXe8nJnidkn_w?key=Xn-v1D8Y1sPgKpX3U16e5Fsb" />
+
+A window will appear that will allow you configure important settings for the creation of thew new store.
+
+<img height="483" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe8Q7EYfFKmeLMaWEJKcFbrW6MWIMZYGtObKCxGEjRaOy8AE472kR17CW-kNfe_wTA-THhBGjJbJQxFHVa19BRmxLZpsti5_9FVAZJicQHrw_h98N9MF626wzMErqo-zVHtHe0Xuw?key=Xn-v1D8Y1sPgKpX3U16e5Fsb" />
+
+There are five to be completed before creating the new store:
+
+* Site Name - the name that’s displayed in social sharing links, search engines, and browser tabs
+
+* Country - the country you’ll be selling to
+
+* Currency - the currency you’ll be selling in
+
+* Import Products - whether or not you’d like to import products from another store
+
+* Import Payment Methods - whether or not you’d like to important payment methods from another store
+
+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.
+
+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.
+
+<img height="388" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfSxOAyzzW_loDN8lPcwSszOYwm45kS37j2OLAmx4ZrrQyCcAzeMw9aV9bcJryodTnvHN5r0wLTKDtRyQpFhkLiBuh-9TeuX3baqprUY-tO7p0LmrU89z8eQaaU3kh34QbuTyVE8g?key=Xn-v1D8Y1sPgKpX3U16e5Fsb" />
+
+## 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
+
+* Store Credits
+
+* Gift cards
+
+* Blogs Posts
+
+* Themes & Pages
+
+* Integrations eg. Google Analytics, Meta Pixel, etc.
+
+For more information about multi-store management, please refer to another support article.
\ No newline at end of file
diff --git a/docs/user/storefront/create-new-theme.mdx b/docs/user/storefront/create-new-theme.mdx
index 80d8b1d5fb..332b07d20e 100644
--- a/docs/user/storefront/create-new-theme.mdx
+++ b/docs/user/storefront/create-new-theme.mdx
@@ -1,5 +1,50 @@
---
-title: 'New file'
-description: 'Description of your new file.'
+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."
---
+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. 
+
+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.
+
+## Create a New Theme
+
+To create a new theme, navigate to the Storefront tab of the admin dashboard.
+
+![](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)
+
+Here, you’ll find two options to create a new theme.
+
+### Duplicate 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.
+
+To duplicate a theme, find the theme you’d like to copy, click the three dots on the right hand side, and select Duplicate.
+
+![](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 duplicate will be added to your list of themes and can now be updated and experimented with without affecting the live storefront.
+
+![](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)
+
+### Add a New Theme
+
+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.
+
+![](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)
+
+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.
+
+![](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)
+
+## 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.
+
+You can publish a theme at any time by clicking the “Publish” button on the right hand side.
+
+![](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)
+
+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
diff --git a/docs/user/storefront/create-page.mdx b/docs/user/storefront/create-page.mdx
new file mode 100644
index 0000000000..23f8441571
--- /dev/null
+++ b/docs/user/storefront/create-page.mdx
@@ -0,0 +1,24 @@
+---
+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"
+---
+
+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.
+
+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.
+
+To add a new page, navigate to the Pages tab of the admin dashboard found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXemXmApJbf9kicbz0MMI8jXrxUbLXaltTxnX-Oh4ctc-KbdwZ_56P8SUX247SwXLSixk6MwiK_I0GlJ7o6iJNZcbDflYODsyyIP-QqX2jra8mAVvSopOU4gX8UIvRhhUKyYHEwoOQ?key=trw_CpU84amS4xaFyNBZpaUD" />
+
+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.
+
+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.
+
+<img height="319" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcAXWI7dn5-J-SGAcoiXNig9rY3y50smr2HjbUp0Wpe9eBy31Z1YM4jbq0BxDUZW0idR8ZX0jCaohmohzxc5j00hkpxlx38GSrKqxxfdb5v8CIP3JyOpzYZN0sxSAl8V8gSbXNIrw?key=trw_CpU84amS4xaFyNBZpaUD" />
+
+After naming and clicking ‘Create’, you’ll be redirected to the Theme Editor where you can begin customizing the newly created page.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe0WQZusBBjHjfOaTt95jHJWL5XrwWGBoEPEyraAz9836B_5aOfeCzMWKb-9yBMyUvnKadRj_cxB8irHKkaqcfct9FBXeIrge7yIAOQMzej7VzzBT9cVgfvwjk3V0w5Xu2bIc2K?key=trw_CpU84amS4xaFyNBZpaUD" />
+
+For more information about using the Theme Editor to customize your page, please refer to this support article.
\ No newline at end of file
diff --git a/docs/user/storefront/create-post.mdx b/docs/user/storefront/create-post.mdx
new file mode 100644
index 0000000000..e9cd0a9a52
--- /dev/null
+++ b/docs/user/storefront/create-post.mdx
@@ -0,0 +1,70 @@
+---
+title: "Create a Blog Post"
+description: "Add a new blog post and manage your blog using Spree Commerce for improved SEO, product discovery and sales."
+---
+
+Blog posts are a powerful tool in ecommerce, helping to drive traffic to your store through SEO while building trust and credibility with your audience. They allow you to showcase expertise, share product tips, and engage customers with content that keeps them coming back.
+
+To add a new post, navigate to the Posts sections of the admin dashboard found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcXEGU8-EElTdfTO5tqw8PyaUqoLB6dKLJsIZ091925566kg23DCT1fitl01eENkk2Zc_z_poIao6lHewbXyZERqEJfedkAwb-AduvQL9attJym5Dihw81ru1aP9mTrJv1MNxYQbQ?key=RREDHLGZeHW95bbTnjz4f6hx" />
+
+Locate the blue ‘New Post’ button in the top right corner and click on. This will open the post creation page.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfypnsNgJe5BtuEWKqE2e5sKTj4VEWmpCQsmx3xA6Kn05K17zKLPN_6IdRap7PtxrCzrNa7Ta21XU1X-ySM90TkaDfNslFzhYO47bEzfGQ_dpi-sW0LBeTCW0PhP5OjVG_i8bYhBw?key=RREDHLGZeHW95bbTnjz4f6hx" />
+
+This page is divided into four sections designed to help you create and publish your post.
+
+## Content
+
+<img height="604" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdl04uIbGb1ucdyezvIIv_w4WDY2L4K2o4bLwIOLpwvC2RoWizDQ4udMu1FenBMeTBZCaNjNAlgKCiFWOTRVkQjVfOdIGmBvzHUsYbLQdx4iT_r6rNuqSCzDMgcZgVgXot9yawT?key=RREDHLGZeHW95bbTnjz4f6hx" />
+
+As the name suggests, this section is where you will insert the content of the post. There are three fields to fill in:
+
+* Title link - the title of the blog post
+
+* Content - the main body of the post, you can make use of the rich text editor to format your pos, insert images, and embed videos.
+
+* Excerpt - a short summary of the post that will be displayed on your website
+
+## Featured Image
+
+<img height="525" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdsPhB6HPc_iqb3ROZmLpL82mfiz2BA0GUJfa23uXrFPOPJrhFH6X72lFVotGYGnl5HUsCFgItoy6UpwCKSFV8x4pK03lUNHXsaqBs5Ej4p1jl8a1RsQnVBQrNU7Jv9NGmXvsKVGw?key=RREDHLGZeHW95bbTnjz4f6hx" />
+
+This is where you can upload an image to accompany the post wherever it is displayed. We recommend using an image of size 1200x600.
+
+## Post Details
+
+<img height="423" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdnUQOS_Lr40DRpbUQKdGQt4cMSin-A1Kx89GuAE_KDY3M0e0D6OpwMpEeASa_uXZWlU59nclXQgRhJh0-YgRIge8HfeCjCsJO-oHnjtAAQgiHM157EtlVP98ZumGLMaBAwCQO93g?key=RREDHLGZeHW95bbTnjz4f6hx" />
+
+The post details section contains four fields, two of which are required for the post to be published:
+
+* Author (required)  - the team member who wrote the post, by default the user who is creating the post will be selected
+
+* Category - helps to organize the posts into broad topics or groups
+
+* Published At (required) - the date the post should go live
+
+* Tags - provide more specific labels for your posts, allowing for finer sorting and search
+
+Important: If the Author and Publish At date are not set, the post will not appear on your live website.
+
+## Search Engine Listing
+
+<img height="484" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfpoZWL227p4uO59v5U3ejbUffUsy5fT_PtS-FJipfOHI2CzKR_FzhqSq9iq9P_XG4wxXnkXQZm4rwoBVKRAGa7p9uQ9LyzgQd8blonLpJbPJg68HaIJ_hxfz9drY-X-YtyXFEw?key=RREDHLGZeHW95bbTnjz4f6hx" />
+
+Here you can edit the following fields:
+
+* Meta Title - if not set, the Title Link will be used
+
+* Meta Description - if not set, the Excerpt will be used
+
+* Slug - if not set, the Title Link will be used
+
+## Click Create
+
+Now that you’ve finished adding all of the content to your post and configuring the settings, all that’s left to do is to click the blue ‘Create’ button at the bottom of the page.
+
+Congratulations, you’ve just published your first post!
+
+<img height="364" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf1JwfBqlzA5hbEXpcpPLKkTRNHkZEVkrvcrXNvat2NvWF1JGss90n30tnOAfJalqJThayKXaK18oDurIXXKI3IXuo2MdsXGvQwwTk0EEECzqFnuPEf81VCr6Q7VTjMRwPBBS7i?key=RREDHLGZeHW95bbTnjz4f6hx" />
\ No newline at end of file
diff --git a/docs/user/storefront/delete-page.mdx b/docs/user/storefront/delete-page.mdx
new file mode 100644
index 0000000000..9ff8d0878b
--- /dev/null
+++ b/docs/user/storefront/delete-page.mdx
@@ -0,0 +1,24 @@
+---
+title: "Delete a Landing Page"
+description: "Delete a landing page you no longer need."
+---
+
+When a page is no longer needed, you can remove it to keep your backend organized and clutter-free.
+
+To delete a page, navigate to the Pages tab of the admin dashboard, found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd8ijBrIUNPcDGN6vDiQY4FFuLBazMRGm2Rc-qKjmZVfF9r9kt0pitdjE5f_WjqFpzG5I4XPo5m-8DRfbUvc0I2s1gfBGE4n9WcqBEIXsCYr5GIxh3oOmCB9wdGVXVuW40moeLM?key=wFDXEcsw7QqwrKfLfsp4Zxsi" />
+
+Find the page you want to delete and click on it. This will open the Theme Editor for that specific page.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXda6b7WQ0TyAfVqbvBRQ8yT51cWYrZaDVfh6pf6q8VKnF8Id_s7Xsl7_Q-r3Vvj5MkbeVcCwzOW7-fjv4Nu3oqirVSQE7MBcItaTYlio-ZSUzkMBIjz4rgUWM0wWGfvbNKA2EPJfw?key=wFDXEcsw7QqwrKfLfsp4Zxsi" />
+
+Click on ‘Page Settings’ found on the right hand side of the top bar Theme Editor. This will open the page settings window.
+
+<img height="399" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfqUmar5ARCm7c4yBJfbV8e2jbCLD4PCI8CEYYPoJupOf0GxqvOitKgSad6_rgWkMbSk7e_Q-m8qU1fM1r_UCF8ze8pbTbTifiq91T9CCdtPdDSaztW7iWBPrc8HpYB_Vtfyzo6IA?key=wFDXEcsw7QqwrKfLfsp4Zxsi" />
+
+Click the red ‘Delete’ button and the page will be removed from your website.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe8dmrRdSis3p6fz-renI4NtsJK2zGN78ifG5DUOKrdTGEufJ6Byn3ButZWlMOzHGVZ1ZFETbYVApxef4D-gjnHtqNf9sjEETn7VBsRKasOIED0vqYXCGQLRMZZI7l5hksJFykh6Q?key=wFDXEcsw7QqwrKfLfsp4Zxsi" />
+
+Congratulations, you just de-cluttered your website!
\ No newline at end of file
diff --git a/docs/user/storefront/delete-post.mdx b/docs/user/storefront/delete-post.mdx
new file mode 100644
index 0000000000..7aec9a5b72
--- /dev/null
+++ b/docs/user/storefront/delete-post.mdx
@@ -0,0 +1,22 @@
+---
+title: "Delete a Blog Post"
+description: "Delete a blog post and manage your entire blog using Spree Commerce."
+---
+
+At some point, you might want to delete a post if it’s outdated, no longer relevant, or doesn’t align with your current content strategy.
+
+To delete a post, navigate to the Posts tab of the admin dashboard found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe0AsJO3UWEcw6S0X1QbMqUxQji0NNchNkGSfRyRt_6Xqp4wMUQIWwvxsSU4bswpBq81NrtJ3zhmVwmv9W0gD0E9d3hJ0dmV-BqyM05hjkmjKRU5i4_G8kb_4EUaaF0HPQSTax1HQ?key=xlFyZS8Qk0f4G156jvjemdwP" />
+
+Find the post you’d like to delete and click on it to open the post editor for that specific post.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfErSOqnsWdDYAh96m8VDxBvbaqCyWi_oeGXPHWC56GQCKLHK7QljYdlDUYOHWUcbtiDEmLDS1RLF-lmzeU164N7Zp3Po1kQBYcQVC-N0mbdlfR7sa7M7JX-s-Cs1f77e54K5Q-bQ?key=xlFyZS8Qk0f4G156jvjemdwP" />
+
+Scroll to the bottom of the page and locate the red ‘Delete’ button in the bottom right corner under SEO settings.
+
+<img height="341" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc-o8V9kia6VmHiLz63zddORBJ4jEmMFIf2pOX8nDfJEwI1STfR7UROsPr3FHClNiLGMd6eNCznOTRO5pjxCo898vUAnFRC_OYiFsPUJzMid5ILCxC4caN9tc4ayQ1USWh4YchWCg?key=xlFyZS8Qk0f4G156jvjemdwP" />
+
+Click ‘Delete’ and the post will be removed from your site.
+
+<img height="399" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXebJLeMmdGmOFtMC56KdnMzZgO20tOMPHa_JSYeWu-wSIDuWgC9ihKPTVBmlJmmQn2AgJtBACmaNWmNWgf5QxjweK-2uPNyxhc6qzv0WNn-ysv93ivBNiHkwH0OTSPguax7lvuJmw?key=xlFyZS8Qk0f4G156jvjemdwP" />
\ No newline at end of file
diff --git a/docs/user/storefront/delete-theme.mdx b/docs/user/storefront/delete-theme.mdx
index 80d8b1d5fb..13dab5e2fe 100644
--- a/docs/user/storefront/delete-theme.mdx
+++ b/docs/user/storefront/delete-theme.mdx
@@ -1,5 +1,10 @@
---
-title: 'New file'
-description: 'Description of your new file.'
+title: "Delete a Theme"
+description: "Delete a Theme and manage your storefront without any developer help."
---
+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.
+
+<img height="371" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcJp1pCh1I5s98FdVDIxkUrx5V7lZZVOV44rWtClqCnqc10Hx8uxghTLIDLhdiGiRT3ZhfepRVK7o4cadjEfKkpj2C3Ci9yW2hdyOjmDVJSyYNEe97jQ_Az-Sgtn72gOP1gWxREBA?key=ciVp1TIe6cYImUdB56EsYaS6" />
+
+Note: Only ‘Draft’ themes can be deleted.
\ No newline at end of file
diff --git a/docs/user/storefront/edit-page.mdx b/docs/user/storefront/edit-page.mdx
new file mode 100644
index 0000000000..6bbc089ea1
--- /dev/null
+++ b/docs/user/storefront/edit-page.mdx
@@ -0,0 +1,34 @@
+---
+title: 'Edit a Landing Page'
+description: 'Update the products or content on your custom landing pages without any developer help'
+---
+
+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.
+
+To edit a page, navigate to the Pages tab of the admin dashboard, found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdbBMTBOLrsWwdNfeN14M5PqC4k442AbUFY_kf0VctQS1rB1X9Z_nnVcOZXXrvAywwLGCzBwMzDC2Dh92URbvLky_KwVKTcXGF-rJb9spwpnFs3OF4In-iOvwcj22-6jzTjYSk3?key=Rhw7vMyBZx_anfGhfR9KcWKj" />
+
+Locate the page you’d like to edit and click on it. This will open up the Theme Editor for that specific page.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfgINHDkP_A9VBB0YnoD2K1jl0RsIs5SFNw027psYoLWTZIjsf0DjclF3M39phdn67wHAlRs8isj9kNrl-saoSBDIzNzl5ho3P3bSEGtOr3JbZf4NUS1Ia08xWMuMCG2WDb_v_3?key=Rhw7vMyBZx_anfGhfR9KcWKj" />
+
+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}}
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfyf58YSq-aKHagv3HA8mwo9LshVemVnZrgVak81IW_d649AVwzXtAuGfCTPKhThY6wJl1kRn6ZALaZ64_0Y1nKQob0E0DIURJ6Ls5lENQTdk0V83HzeCLU0NZ2KrMXW8w0Vjov?key=Rhw7vMyBZx_anfGhfR9KcWKj" />
+
+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.
+
+## Page Settings
+
+In the top bar of the Theme Editor, you’ll notice the ‘Page Settings’ button. 
+
+<img height="401" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeRuGVYdSBCdhdMQ8zAzXNQptWAZxUGzqQ0fjHHmsnonYkos3aMmyigMU9RO6_JuY01fUuIrvDuiYoxOLvqIJFoDFDvoBLvtHw0huhuRRysAJXJwWU5jPSiIJ6_RFnfD_NVzJgYig?key=Rhw7vMyBZx_anfGhfR9KcWKj" />
+
+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.
+
+<img height="399" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXduY5WRw3ovUXikpTwhYQGcYcKwK-f5DC_8Q-mWd54ifGAgp57oY63I7ecv2KgLOuPBYOnLd055IjSbGGYrPU2g1MZ1PL6Vm77MmVgP30YnCkpSK-3UA8sWnnskir7B8brUQNx9fw?key=Rhw7vMyBZx_anfGhfR9KcWKj" />
+
+Simply edit the information as required and click the blue ‘Save’ button at the bottom of the window.
+
+For more information about creating pages, please refer to this support article.
\ No newline at end of file
diff --git a/docs/user/storefront/edit-post.mdx b/docs/user/storefront/edit-post.mdx
new file mode 100644
index 0000000000..2babc0f428
--- /dev/null
+++ b/docs/user/storefront/edit-post.mdx
@@ -0,0 +1,22 @@
+---
+title: "Edit a Blog Post"
+description: "Edit your blog post and manage your blog using Spree Commerce"
+---
+
+At some point, you might want to edit a blog post after it’s published to ensure the information remains accurate and up-to-date. Additionally, updating the content can help improve SEO performance and keep it relevant for your audience.
+
+To edit a post, navigate to the Posts tab of the admin dashboard found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdzpkcEBvDfI-yRJotgQybdpnJGSm_r-k4fADhfJ73tIeTgYJjlzRUisRbWF7gayvY3JqPka6FkGbOCIxEV2nHhvJoMX8ya9RBj3dzj8GAauDqFekJ_c1cPIsZCHuK2UbqySDlZ4g?key=4-c_ViISBPAJksS8C7WalMUx" />
+
+Find the post you’d like to edit and click on it. This will open the post editor for that specific post.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe4WHPfm5wod3sN8MJuRINTxbBDdbNPsvEG2TtV34a-Rbzlvvrb1xg2gTyaPEJtrfeUrdu0Lf326u2_1OeSdGh3W0EHV5epYdqUw54-Uz8qjBFixAZEEsIg1axlpccBZq1wUXbGag?key=4-c_ViISBPAJksS8C7WalMUx" />
+
+Feel free to edit any of the content or settings visible on the page.
+
+Once you’re done, make sure to click the blue ‘Update’ button at the bottom of the page, otherwise any changes you’ve made will not be saved.
+
+<img height="383" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfpltKT1FLx3Ru8q2YlZfDizDQeU7STtRdA4UdSRpNkKrWE5ZlTJHL7wGOywC6I9lv5Ue4-wc6n8Fyr8_6f42i054p4XvjhlZoxDmwuNmTAIbTQdIrPzK63eUHqsrZvJ0Z1VGtQiQ?key=4-c_ViISBPAJksS8C7WalMUx" />
+
+Congratulations, you’ve just edited a post!
\ No newline at end of file
diff --git a/docs/user/storefront/import-posts.mdx b/docs/user/storefront/import-posts.mdx
new file mode 100644
index 0000000000..2457353c63
--- /dev/null
+++ b/docs/user/storefront/import-posts.mdx
@@ -0,0 +1,4 @@
+---
+title: "Import Blog Posts"
+description: "Import blog posts from a file to quickly migrate your Wordpress or Shopify blog and start using your built-in Spree Commerce blog."
+---
\ No newline at end of file
diff --git a/docs/user/storefront/search-posts.mdx b/docs/user/storefront/search-posts.mdx
new file mode 100644
index 0000000000..07ae9c8437
--- /dev/null
+++ b/docs/user/storefront/search-posts.mdx
@@ -0,0 +1,24 @@
+---
+title: "Searching Blog Posts"
+description: "Search for blog posts in the backend allows you to quickly locate specific content for updates, edits, or review, saving time when managing multiple posts."
+---
+
+Searching for blog posts in the backend allows you to quickly locate specific content for updates, edits, or review, saving time when managing multiple posts. It also helps you maintain organization by easily accessing posts based on titles, authors, or other criteria.
+
+To search blog posts, navigate to the Posts tab of the admin dashboard found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcwb6AgbgHj92foSZ29YSMqQ3AmJCfbF89UCI2c21hwXS30W0BYtawhL6EcAF79AsoWUilRqBLUt4d6OAo_cbfvAtC6stgypuoypx0AybvU4UqEi28EWlNfayN_McJhD31Be1ITKA?key=5x3COBs47GiiHG_9ldkdBo_y" />
+
+Click on the ‘Filters’ button at the top of the list and to the right of the search bar. This will open the filters UI.
+
+<img height="307" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdanVgUrWfm8U-URM3wIT8GMBCNL7NFkVuSMyeTYPz8-TEbqnAdGDh08bEXYdcXPch6zNRKlEAZ4369m-I23NaaRvcnR372P4aL1DhxDMiH7Xx2GapsD-VGpmUAtlxgM3VAbikVsg?key=5x3COBs47GiiHG_9ldkdBo_y" />
+
+Here you’ll find three options to help refine your search for blog posts.:
+
+* Title Link - filters results by post name or a term included in the name
+
+* Author - filters results by the author of the post
+
+* Category - filters results by the category the post belong to
+
+Using these filters will make blog management much easier, especially if you have a large number of posts.
\ No newline at end of file
diff --git a/docs/user/storefront/storefront-settings.mdx b/docs/user/storefront/storefront-settings.mdx
new file mode 100644
index 0000000000..14cac89cc0
--- /dev/null
+++ b/docs/user/storefront/storefront-settings.mdx
@@ -0,0 +1,134 @@
+---
+title: "Storefront Settings"
+description: "Storefront settings like a favicon, preview image, custom head/body tags, and social media links"
+---
+
+Storefront settings like a favicon, preview image, custom head/body tags, and social media links ensure that your store has a cohesive and professional appearance. 
+
+These elements enhance branding, improve user experience, and optimize how your store is displayed on social media and in search results.
+
+To manage storefront settings, navigate to the Settings tab found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd7YaGTBOGnK3lYWYmT6Pil5dcA-kbgR8WKpcmQab2PmIsStU9H8YJkiGitjayMA-LiyqayZBzUfsjYqzeirmCHlBFLwwBQdFrteoIkAiF9rdUtr0YNuBlsPtqTSzkICO0R-Y69Gw?key=i5rd20yj7mnYDtRJ8MgwNGBh" />
+
+The page is subdivided into 5 distinct section. Let’s take a look at each separately in more detail.
+
+## SEO
+
+<img height="371" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe4xUAmKcVyPO8dy6VlQzj_CjeZ2YW64xNlhk7D7xyXqBU3GTawKvHn2yxsqWlOxOq62OWytjWeB407E7uPHSWafXP0kZlq9RMq2UdOSItpxvM4g5CqJtiz51POgTEL0rkg9j07kA?key=i5rd20yj7mnYDtRJ8MgwNGBh" />
+
+This is where you can manage SEO settings for your store. The three settings are as follows:
+
+* Site Name - the name that’s displayed in social sharing links, search engines, and browser tabs
+
+* Search Description - a short site description displayed in social sharing links and search engines
+
+* Index In Search Engines - checking this box will allow your site to appear in search engines
+
+Note: You might not want your site indexed in search engines if it’s still under development or undergoing significant updates, as unfinished content or errors could negatively impact your brand perception. 
+
+Another scenario would be a member-only platform, in which case you might not want your site indexed to protect exclusive content and ensure that only authorized users can access the information. Preventing indexing helps maintain privacy and exclusivity, aligning with the platform's membership-based model.
+
+Outside of scenarios such as these, you likely want to **make sure that this box is checked** when officially going live.
+
+## Security
+
+<img height="248" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe8qE4ZozFGuxQTsujYkREZgH89BwzhbU3FCgxq2ofrLQrxYtc9Pc-Y17KdzETCAHrFeybq8y5K5ntneK-Q8C69ciX0cN5gN4T5MsPfDJpVl0D61IcV4LWl4Md_QHdir9laN6Kg?key=i5rd20yj7mnYDtRJ8MgwNGBh" />
+
+In the security section, you can choose to make your store password protected and set the password.
+
+To set the password:
+
+1. Check the ‘Password Protected’ box, 
+
+2. Click ‘Update’ at the bottom of the page and the ‘Password’ field will appear
+
+3. Set the password and click ‘Update’ again
+
+Note:
+
+A site might be password protected to restrict access during development, ensuring only authorized users can view and test it before it goes live. This is particularly useful for maintaining privacy and preventing unfinished or unpolished content from being publicly visible. 
+
+Password protection is also ideal for member-only platforms or exclusive content, ensuring access is limited to those with the proper credentials.
+
+## Custom Code
+
+<img height="500" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdp834Vk69M9_nTx2N3UAmMFjrZ-YktC6wzmIGBu6XQ6PAoA_Avf229QZMRaKmoLV2KxqpYlO5jIeluYV2qg4jjpZxVs4rdCIG_rvglgpMof2oLNHInyOudPWS4uIRmkvhV7sgk?key=i5rd20yj7mnYDtRJ8MgwNGBh" />
+
+Adding custom code to the \<head> tag allows you to integrate scripts, styles, or metadata critical for SEO, analytics, or third-party tools. Placing code after the \<body> tag or before the \</body> tag enables you to add functionality such as tracking scripts or custom JavaScript without interfering with the primary content loading process.
+
+Simply enter your code into the appropriate box and click ‘Update’ at the bottom of the page.
+
+## Images
+
+### Favicon Image
+
+<img height="367" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfX_sl6TF9XZuF1bapXeNBI46wkhoJYR3BYmYsHfMR940KzHusMNmhLR5HxdSsxYgiLhCiJikE3sUQ_SkNUMHmV-anXp4dwM2e-onEG1nZvBrqxu5AJvNJihfy-YhSkcra2alHj?key=i5rd20yj7mnYDtRJ8MgwNGBh" />
+
+A favicon is a small image that appears in the tab of your web browser when you visit a website. It is usually a tiny square or rectangle with a unique design or logo that represents your website.
+
+A favicon is important because it enhances your brand's recognition, making your site easily identifiable in browser tabs, bookmarks, and search results.
+
+Simply upload your favicon image (rec. size 120x120px) and click ‘Update’ at the bottom of the page.
+
+### Preview Image
+
+<img height="320" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdkkvgB1_D51d6GCUi4fNJ-gJetEEedbYdU62IE0TtBPDHkAaBEmWjZWVv0Z0MY1d25FOo5oMFhfVOMRPs3kSUCh3P8_gNdpEY5UowYr5NX31K_tq1hTH1jpprMVFMVcAlqO7KDqQ?key=i5rd20yj7mnYDtRJ8MgwNGBh" />
+
+The preview image will be used when your store is shared on social media or in search engines.
+
+A preview image is important because it visually represents your site when shared on social media or in messaging apps, helping to attract clicks and reinforce your branding.
+
+Simply upload your preview image (rec. size 120x120px) and click ‘Update’ at the bottom of the page.
+
+## Social Media
+
+<img height="335" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeRKSELEDw4iAtHSgl8TcBV_YL4tcQ_n29dzN2HaAK47YcFYE5d7m49MYHtxMBEwSqIPJdoe6W10e22taQxS-XxQQ3SWeyHYzUKDLksncb4cCsMDNQYTXnLCtlUZCw35MMiL5hSrw?key=i5rd20yj7mnYDtRJ8MgwNGBh" />
+
+The social media section allows you to add all of your social links which will be automatically displayed in your footer with their respective icons.
+
+You can add social links for the following platforms:
+
+* Instagram
+
+* Facebook
+
+* Twitter
+
+* Pinterest
+
+* Tiktok
+
+* Youtube
+
+* Spotify
+
+## Click Update
+
+Once you’re finished configuring your storefront settings, make sure to click the blue ‘Update’ button at the bottom of the page, otherwise your changes will not be saved.
+
+Congratulations, your store is now optimized for branding, user experience, and visibility!
+
+***
+
+title: "Delete a Blog Post"
+description: "Description of your new file."
+--------------------------------------------
+
+At some point, you might want to delete a post if it’s outdated, no longer relevant, or doesn’t align with your current content strategy.
+
+To delete a post, navigate to the Posts tab of the admin dashboard found under Storefront.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeymify8zV10gAEQvRWzwuqiUkdmqorOUaijgR1Awry47Y2w9quKJIUeS0O1GDuwwGxwHGCwDdfYbomwAgdtxnfgA7dykFg51Xavz171_e6qgQWHq0TPC1nGdJ9mJGSQuXs6m23LQ?key=xlFyZS8Qk0f4G156jvjemdwP" />
+
+Find the post you’d like to delete and click on it to open the post editor for that specific post.
+
+<img height="359" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeFmde7FQ3apOaquUuRwYaniKUnsUaUDBq8rNTVziFFLzKQVcc7uRop-kSXXSqF1B4Iq7lSAuqzDe2xmoOyF5MhfGDgM29Nl_vFsFSsryk3JAacV1nMkP39uOyPuZyR-XJ8XfoSgw?key=xlFyZS8Qk0f4G156jvjemdwP" />
+
+Scroll to the bottom of the page and locate the red ‘Delete’ button in the bottom right corner under SEO settings.
+
+<img height="341" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeCjGZ_-jDZmSmoQ7cbJPtmZBEhOC4-6XLh7jj3R86UzeY_qEHjXKAucQ4TWtJdnFUuu8JGtWjh0EE9wZtmPtMFPw7Jw5XwE-5ckxQFe7QNUbAvc07BQTKQ_NRQX9qklbKI-sbJtw?key=xlFyZS8Qk0f4G156jvjemdwP" />
+
+Click ‘Delete’ and the post will be removed from your site.
+
+<img height="399" width="624" src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXebJLeMmdGmOFtMC56KdnMzZgO20tOMPHa_JSYeWu-wSIDuWgC9ihKPTVBmlJmmQn2AgJtBACmaNWmNWgf5QxjweK-2uPNyxhc6qzv0WNn-ysv93ivBNiHkwH0OTSPguax7lvuJmw?key=xlFyZS8Qk0f4G156jvjemdwP" />
\ No newline at end of file