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 User Quickstart doc (#13271)

jaburghes29a4460198f7
diff --git a/docs/images/user/quickstart/1-getting-started.png b/docs/images/user/quickstart/1-getting-started.png
new file mode 100644
index 0000000000..2c18031563
Binary files /dev/null and b/docs/images/user/quickstart/1-getting-started.png differ
diff --git a/docs/images/user/quickstart/10-theme-editor.png b/docs/images/user/quickstart/10-theme-editor.png
new file mode 100644
index 0000000000..6aed8573ce
Binary files /dev/null and b/docs/images/user/quickstart/10-theme-editor.png differ
diff --git a/docs/images/user/quickstart/11-connect-domain.png b/docs/images/user/quickstart/11-connect-domain.png
new file mode 100644
index 0000000000..2a46708bd7
Binary files /dev/null and b/docs/images/user/quickstart/11-connect-domain.png differ
diff --git a/docs/images/user/quickstart/12-pages.png b/docs/images/user/quickstart/12-pages.png
new file mode 100644
index 0000000000..5f19c496a0
Binary files /dev/null and b/docs/images/user/quickstart/12-pages.png differ
diff --git a/docs/images/user/quickstart/13-add-new-page.png b/docs/images/user/quickstart/13-add-new-page.png
new file mode 100644
index 0000000000..8fc57d4989
Binary files /dev/null and b/docs/images/user/quickstart/13-add-new-page.png differ
diff --git a/docs/images/user/quickstart/14-posts.png b/docs/images/user/quickstart/14-posts.png
new file mode 100644
index 0000000000..3c87637157
Binary files /dev/null and b/docs/images/user/quickstart/14-posts.png differ
diff --git a/docs/images/user/quickstart/15-new-post.png b/docs/images/user/quickstart/15-new-post.png
new file mode 100644
index 0000000000..b6f12af229
Binary files /dev/null and b/docs/images/user/quickstart/15-new-post.png differ
diff --git a/docs/images/user/quickstart/16-storefront-settings.png b/docs/images/user/quickstart/16-storefront-settings.png
new file mode 100644
index 0000000000..440e6c14cc
Binary files /dev/null and b/docs/images/user/quickstart/16-storefront-settings.png differ
diff --git a/docs/images/user/quickstart/17-multi-store.png b/docs/images/user/quickstart/17-multi-store.png
new file mode 100644
index 0000000000..4a5316852b
Binary files /dev/null and b/docs/images/user/quickstart/17-multi-store.png differ
diff --git a/docs/images/user/quickstart/18-new-store.png b/docs/images/user/quickstart/18-new-store.png
new file mode 100644
index 0000000000..44b2063778
Binary files /dev/null and b/docs/images/user/quickstart/18-new-store.png differ
diff --git a/docs/images/user/quickstart/19-home-screen.png b/docs/images/user/quickstart/19-home-screen.png
new file mode 100644
index 0000000000..d799b1c15a
Binary files /dev/null and b/docs/images/user/quickstart/19-home-screen.png differ
diff --git a/docs/images/user/quickstart/2-setup-payments.png b/docs/images/user/quickstart/2-setup-payments.png
new file mode 100644
index 0000000000..167d7e5ce3
Binary files /dev/null and b/docs/images/user/quickstart/2-setup-payments.png differ
diff --git a/docs/images/user/quickstart/20-reports.png b/docs/images/user/quickstart/20-reports.png
new file mode 100644
index 0000000000..a685349dc4
Binary files /dev/null and b/docs/images/user/quickstart/20-reports.png differ
diff --git a/docs/images/user/quickstart/3-settings-payments.png b/docs/images/user/quickstart/3-settings-payments.png
new file mode 100644
index 0000000000..76ec6bec4d
Binary files /dev/null and b/docs/images/user/quickstart/3-settings-payments.png differ
diff --git a/docs/images/user/quickstart/4-add-products.png b/docs/images/user/quickstart/4-add-products.png
new file mode 100644
index 0000000000..ce3c127982
Binary files /dev/null and b/docs/images/user/quickstart/4-add-products.png differ
diff --git a/docs/images/user/quickstart/5-customer-support-email.png b/docs/images/user/quickstart/5-customer-support-email.png
new file mode 100644
index 0000000000..c15b383ccb
Binary files /dev/null and b/docs/images/user/quickstart/5-customer-support-email.png differ
diff --git a/docs/images/user/quickstart/6-setup-taxes.png b/docs/images/user/quickstart/6-setup-taxes.png
new file mode 100644
index 0000000000..8a5a07b8eb
Binary files /dev/null and b/docs/images/user/quickstart/6-setup-taxes.png differ
diff --git a/docs/images/user/quickstart/7-shipping-methods.png b/docs/images/user/quickstart/7-shipping-methods.png
new file mode 100644
index 0000000000..d055ddfc43
Binary files /dev/null and b/docs/images/user/quickstart/7-shipping-methods.png differ
diff --git a/docs/images/user/quickstart/8-storefront-setup.png b/docs/images/user/quickstart/8-storefront-setup.png
new file mode 100644
index 0000000000..47338c3ada
Binary files /dev/null and b/docs/images/user/quickstart/8-storefront-setup.png differ
diff --git a/docs/images/user/quickstart/9-themes.png b/docs/images/user/quickstart/9-themes.png
new file mode 100644
index 0000000000..6154e53748
Binary files /dev/null and b/docs/images/user/quickstart/9-themes.png differ
diff --git a/docs/user/user-quickstart-guide.mdx b/docs/user/user-quickstart-guide.mdx
index 83fd74c4bf..655d748d15 100644
--- a/docs/user/user-quickstart-guide.mdx
+++ b/docs/user/user-quickstart-guide.mdx
@@ -1,379 +1,246 @@
---
title: "User Quickstart"
-description: "Start selling with Spree Commerce open-source eCommerce solution"
+description: "Start selling with the Spree Commerce open-source eCommerce solution"
---
-When first logging in to your instance of Spree Commerce [open-source eCommerce platform](https://spreecommerce.org/), you’ll be greeted with the Getting Started tab which, by default, outlines 4 onboarding tasks you’ll need to complete.
+Spree Commerce gives you a powerful, flexible platform to build and manage your online store - but before you can start selling, there are a few key steps to complete. 
-<img
- alt="Getting started with Spree Commerce - an Open Source e-commerce platform"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.1_Getting_Started_pwvjhm"
-/>
+This guide walks you through the essential setup tasks, from configuring payments and taxes to adding products and launching your storefront. Whether you're launching an MVP or just exploring Spree’s capabilities, this guide will help you get up and running quickly.
-Once you’ve completed these tasks, this tab will disappear.
+## Getting Started
-Let’s take a look at each task in more detail.
+![Getting Started tab showing the onboarding checklist with four key tasks](/docs/images/user/quickstart/1-getting-started.png)
-## Set up payments
+When you log into a fresh Spree Commerce instance, you’ll land on the Getting Started tab - a quick-launch checklist that helps you configure the essentials and go live faster.
-It shouldn’t come as a surprise that in order to sell anything, you need to accept payments, and in order to accept payments, you need to add payment methods.
+You’ll see four key onboarding tasks:
-To setup payment methods, click on the blue button which will redirect you to the Payment Methods section of Settings.
+- Setup payments
+- Add products
+- Set customer support email
+- Setup taxes collection
-<img
- alt="Payment Methods"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.2_Getting_Started_-_Payment_Methods_danmea.png"
-/>
+Once all tasks are completed, the checklist will disappear from view. Let’s walk through each step below.
-At the top, there’s a list of added payment methods, each of which you can toggle on/off, change its visibility on the storefront or admin panel, and edit. The Store Credits payment methods is always added by default, but alone it does not enable to accept payments from customers.
+### Setup Payment Method
-Below that, you’ll see a list of available payment methods that you can add to your store.
+![Payment setup onboarding step](/docs/images/user/quickstart/2-setup-payments.png)
-Find the method you’d like to use and click ‘\+ Add’. This will redirect you to the set up page for that particular payment method.
+To sell anything, you’ll need to configure at least one payment method.
-Important: to use any of these available payment methods, you are required to first set up an account with the associated payment service provider.
+Click **Setup Payment Method** to jump to **Settings → Payments**.
-<img
- alt="Create Payment Method"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.3_Getting_Started_-_Create_Payment_Method_i0xp8m.png"
-/>
+![Payments section of admin dashboard](/docs/images/user/quickstart/3-settings-payments.png)
-Simply follow the steps outlined for that payment method, click Create, and the payment method will be added to your store.
+At the top, you’ll see your currently enabled methods (e.g., Store Credits, added by default). 
-<img
- alt="Payment Method Added"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.4_Getting_Started_-_Payment_Method_Added_eojwfj.png"
-/>
+Below that is a list of available payment methods you can add, such as Stripe, Adyen or PayPal.
-To learn more about Payment Methods, please refer to a separate support article.
+<Note>Only payment methods that have been installed will appear in the Available Payment Methods list. If a method you’re expecting isn’t listed, ask your developer to confirm it has been added to the codebase.</Note>
-## Add products
+To add a method:
-Next on the list is adding products.
+1. Click **Add** next to your chosen method
+2. Follow the setup instructions in the form
+3. Click **Create** to enable it
-<img
- alt="Add Products"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.5_Getting_Started_-_Add_Products_cxbdq5.png"
-/>
+<Note>Most payment gateways require you to have an account with the provider before setup.</Note>
-There are three ways to add products to your store:
+To learn more about available methods and configuration, see [<u>Payments</u>](https://spreecommerce.org/docs/user/settings/payments).
-1. Adding products manually
-2. Importing products with CSV
-3. Inviting vendors (3rd party products)
+### Add Products
-Please refer to the respective articles for more information on each method of adding products.
+![Add products Spree onboarding step](/docs/images/user/quickstart/4-add-products.png)
-<Note>
- Inviting 3rd party vendors to your marketplace is only available in the Spree Enterprise Edition.
-</Note>
+There are three ways to populate your store’s catalog:
-## Set customer support email
+- [<u>Add products manually</u>](https://spreecommerce.org/docs/user/products/creating-products) (ideal for small catalogs or testing)
+- Import products using CSV (essential for large catalogs)
+- [<u>Invite vendors to add their own products</u>](https://spreecommerce.org/docs/user/vendors/invite-vendor) (for marketplaces - Spree Enterprise only)
-The next task is a simple one, but it plays a very important role.
+Click the **Add Products** button to start adding manually, or refer to the relevant articles based on your method.
-<img
- alt="Add Customer Support Email"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.6_Getting_Started_-_Add_Customer_Support_Email_ahnei4.png"
-/>
+Once you’ve added some products, make sure to set them as **Active** to publish them on the storefront.
-You need to add a customer support email to display on your storefront. This email serves as a contact point for your customers to reach out to you if they have any queries or require support.
+For more detailed guides on creating and managing products, see:
-Simply type in the email address you’d like to use and click save.
+- [<u>Creating Products</u>](https://spreecommerce.org/docs/user/products/creating-products)
+- [<u>Editing Products</u>](https://spreecommerce.org/docs/user/products/editing-products)
+- [<u>Editing Multi-Variant Products</u>](https://spreecommerce.org/docs/user/products/editing-multi-variant-products)
+- [<u>Managing Products in Bulk</u>](https://spreecommerce.org/docs/user/manage-products/bulk-product-operations)
-## Setup taxes collection
+### Add Customer Support Email
-The last task to complete in the Getting Started is setting up taxes collection.
+![Add a customer support email onboarding step](/docs/images/user/quickstart/5-customer-support-email.png)
-<img
- alt="Setup Taxes Collection"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.7_Getting_Started_-_Setup_Taxes_Collection_nwt1zn.png"
-/>
+This small but critical step ensures customers know how to reach you.
-Follow the link in the description and you’ll be redirected to the Tax section of Settings.
+Simply enter your customer support email in the field provided, and click **Save**.
-To learn more about setting up taxes, please refer to a separate support article.
+This address will appear on your storefront and works as a contact for your customers in case they have any queries or require support.
-## Shipping Methods
-
-To allow customers to actually place orders, there must be shipping methods available for them to select on checkout.
-
-You can add shipping methods by navigating to the Shipping section in Settings.
-
-<img
- alt="Shipping Methods"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.8_Getting_Started_-_Shipping_Methods_ailaai.png"
-/>
-
-To add a new shipping method, click the blue button in the top right corner. This will open to shipping method editor.
+### Setup Taxes Collection
-<img
- alt="Add A Shipping Method"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.9_Getting_Started_-_Add_A_Shipping_Method_wf4ajh.png"
-/>
+![Setup tax collection ecommerce onboarding step](/docs/images/user/quickstart/6-setup-taxes.png)
-Here you can configure the settings of the shipping method, such as the shipping zones, calculator and costs, and estimated delivery time.
+To charge the correct taxes at checkout, click **Setup Tax Rates** to be taken to **Settings → Tax**.
-For more information about shipping methods, please refer to a separate support article.
+From here, you can configure:
-## Basic Storefront Setup
+- Tax rates (manual or through third-party services like Avalara)
+- Tax categories
-Now that you’ve configured payments, taxes, and shipping, and added some products, it’s time to configure your storefront.
+For full instructions, please refer to our [<u>Tax support article</u>](https://spreecommerce.org/docs/user/settings/tax).
-Spree comes with a drag and drop page builder with pre-built page sections that allows you to quickly and easily configure a storefront. This is a great option for MVPs or other projects that don’t require a lot of custom frontend features.
-
-If you’re planning on using Spree in headless mode and connect it to a separate storefront application, please refer to [Spree developer documentation](https://spreecommerce.org/docs/developer/getting-started/quickstart).
+## Shipping Methods
-The Storefront tab of the admin dashboard, found under Channels & Apps, contains four sections that manage various parts of your storefront.
+![Configure shipping methods Spree onboarding step](/docs/images/user/quickstart/7-shipping-methods.png)
-### Theme
+Customers won’t be able to complete orders without at least one shipping method configured.
-This is where you can modify the layout and look and feel of your storefront.
+To configure a shipping methods, go to **Settings → Shipping** and click **New Shipping Method** to define:
-<img
- alt="Theme"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.10_Getting_Started_-_Theme_nmwoh4.png"
-/>
+- Shipping zones
+- Cost calculator settings
+- Estimated delivery times
+- Shipping and Tax categories
+- Tracking links
-#### View Store
+See [<u>Shipping Methods</u>](https://spreecommerce.org/docs/user/settings/shipping-methods) for a full breakdown of settings and examples.
-To view the live storefront, click on the View Store button on the top right corner. If you haven’t modified the theme at all, you’ll see what is essentially a blank slate with a few default page sections, and perhaps some products if you’ve made them Active.
+<Note>By default, all Spree stores have a Digital Delivery method pre-configured. If you plan on selling digital products, be sure to assign those products the Digital shipping category.</Note>
-<img
- alt="View_Store"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327023/docs/Getting%20Started/1.11_Getting_Started_-_View_Store_jynqgp.png"
-/>
+## Storefront Setup
-With a little investment of your time, you can turn this into something presentable, shoppable, and on-brand without the need to hire developers (or even designers if it’s an MVP).
+![Setup a Spree storefront without code](/docs/images/user/quickstart/8-storefront-setup.png)
-<img
- alt="Styled Store on Spree"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327026/docs/Getting%20Started/1.12_Getting_Started_-_Modified_Store_tfdwxm.png"
-/>
+Once your product catalog, payments, taxes, and shipping are ready, it's time to build your storefront. Spree gives you a built-in visual page builder that lets you design your storefront without writing any code.
-#### Connect Your Own Domain
+Navigate to **Storefront** in the admin dashboard to access:
-At the top of the Theme section, you’ll notice a prompt to connect your own domain. Clicking on this will lead you to the Domains section of Settings where you can connect your domains and subdomains.
+### Themes
-<img
- alt="Connect Your own Domain"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327026/docs/Getting%20Started/1.13_Getting_Started_-_Connect_Your_own_Domain_ay8q1s.png"
-/>
+![Create and manage themes in the admin dashboard](/docs/images/user/quickstart/9-themes.png)
-#### Theme Editor
+Here you can customize the design, layout, and branding of your storefront, and add new themes that you can switch between when desired.
-To edit the store’s default Theme, simply click on it or click the three dots on the left and select Edit.
+Simply click on the theme you wish to edit to launch the Theme Editor.
-<img
- alt="Theme Editor"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327026/docs/Getting%20Started/1.14_Getting_Started_-_Theme_Editor_qxfbsu.png"
-/>
+![A screenshot of the Spree theme editor](/docs/images/user/quickstart/10-theme-editor.png)
-This will open the visual page builder UI that allows you to easily add or modify page sections, upload visual media, and change color schemes and fonts.
+If this is a fresh Spree installation, you’ll see the blank, default layout. However, here you can easily:
-<img
- alt="Drag & Drop Visual Page Builder Composer"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327026/docs/Getting%20Started/1.15_Getting_Started_-_Page_Builder_c63a2a.png"
-/>
+- Add and arrange pre-built page sections
+- Update global theme settings like fonts and colors
+- Upload and swap out media in individual sections
+- Switch between mobile and desktop editor preview
+- Click **Publish** in the top right when you're ready to save changes
-Themes are mobily-reponsive, and you can switch between views by clicking on the mobile or desktop icons in the top right corner.
+For a detailed guide on customizing your storefront theme, please refer to our [<u>Theme Editor support article</u>](https://spreecommerce.org/docs/user/storefront/theme-editor).
-<img
- alt="Page Builder Mobile View"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327026/docs/Getting%20Started/1.16_Getting_Started_-_Page_Builder_Mobile_View_qbmdp9.png"
-/>
+<Warning>Changes are only saved when published. Previewing alone does not make them live.</Warning>
-Important: Whenever you make changes to the storefront, it’s important to publish them before backing out of the page builder otherwise all progress will be lost. To publish changes, click the blue button in the top right corner.
+### Connect Your Domain
-You can also preview changes you’ve made to the storefront without publishing them by clicking Preview in the top right corne.
+![Connecting a domain to Spree commerce](/docs/images/user/quickstart/11-connect-domain.png)
-For a comprehensive guide to using the page builder, please refer to a separate support article.
+At the top of the Themes section, click **Connect your own domain** to add a custom domain or subdomain. This will redirect you to **Settings → Domains** where you can complete the setup of your custom domain.
### Pages
-This where you can add static pages to your store, such as About Us, Contact Us, landing pages, etc.
-
-<img
- alt="Content Pages"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327027/docs/Getting%20Started/1.17_Getting_Started_-_Pages_didkze.png"
-/>
-
-To add a new page, simply click on the blue button in the top right corner, give the page a name, edit the SEO settings, and then click Create at the bottom of the page.
+![A dashboard tab showing page management UI](/docs/images/user/quickstart/12-pages.png)
-<img
- alt="Add A New Page"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327027/docs/Getting%20Started/1.18_Getting_Started_-_Add_A_New_Page_mmht9c.png"
-/>
+Use the Pages section to add static pages like:
-After creating the page, you’ll be redirected to the page builder where you can configure the layout and insert content for the new page.
+- About Us
+- Contact
+- Custom landing pages
-<img
- alt="Publish New Page"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327027/docs/Getting%20Started/1.19_Getting_Started_-_Publish_New_Page_huxsg6.png"
-/>
+Click **Add new page** and fill in the page name and SEO fields. 
-Once you’re finished, click Publish and the new page will be added to your store.
+![Ecommerce dashboard showing a page creation form](/docs/images/user/quickstart/13-add-new-page.png)
-<img
- alt="New Page Added"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327027/docs/Getting%20Started/1.20_Getting_Started_-_New_Page_Added_z5zikq.png"
-/>
+Click Create to finalize the settings of the new page, and you’ll be taken directly to the Theme Editor to edit the content of your new page.
-You can edit pages at any time by simpling clicking on them, and you can delete the page by navigating to Page Settings at the top left of the page builder, and clicking Delete.
-
-<img
- alt="Delete A Page"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327028/docs/Getting%20Started/1.21_Getting_Started_-_Delete_A_Page_nydiix.png"
-/>
+To learn more about Pages, please refer to our [<u>Pages</u>](https://spreecommerce.org/docs/user/storefront/create-page) support article.
### Posts
-Here you can make use of Spree’s built-in blog to add blog posts to your store. Adding blog posts to your store is a great way to improve SEO, and the posts themselves can be used for social sharing or ads.
-
-<img
- alt="Posts"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327027/docs/Getting%20Started/1.22_Getting_Started_-_Posts_axgngz.png"
-/>
-
-To add a new post, simply click on the blue button in the top right corner.
-
-Note: If you’re using Spree Enterprise Edition, you can import blog posts in bulk from your previous site by uploading a CSV file.
-
-<img
- alt="Add A New Post"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327029/docs/Getting%20Started/1.23_Getting_Started_-_Add_A_New_Post_kkg1kw.png"
-/>
+![Ecommerce dashboard with a blog CMS](/docs/images/user/quickstart/14-posts.png)
-This will redirect you to the blog post editor where you can add content, visual media, and modify SEO settings for the new post.
+Spree includes a built-in blogging tool that’s great for content marketing and SEO.
-Make sure to add a Published At date, otherwise it won’t appear on the live site.
+To add a blog post, go to **Storefront → Posts** and click **New Post**.
-Once you’re done, click Create to add the new blog post to site.
+![A blog post editor in Spree Commerce](/docs/images/user/quickstart/15-new-post.png)
-<img
- alt="Publish New Post"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327028/docs/Getting%20Started/1.24_Getting_Started_-_Publish_New_Post_ee0xos.png"
-/>
+Simply, fill in your post content, image, and SEO fields, set a Published At date, and click **Create** to finalize your new post.
-You can edit old blog posts by simply clicking on them, making changes, and then clicking Update at the bottom of the page.
-
-Here’s the new blog post on the storefront:
-
-<img
- alt="New Post Storefront View"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327030/docs/Getting%20Started/1.25_Getting_Started_-_New_Post_Storefront_View_meloyu.png"
-/>
+To learn more about Posts, please refer to our [<u>Posts</u>](https://spreecommerce.org/docs/user/storefront/create-post) support article.
### Storefront Settings
-This is where you can configure some important settings for the storefront, such as SEO, security, favicon and social sharing images, and social media links.
-
-<img
- alt="Storefront_Settings"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327029/docs/Getting%20Started/1.26_Getting_Started_-_Storefront_Settings_q94xc6.png"
-/>
-
-Important: If you want your store to be shown in search engines, make sure to uncheck the box next to “Do not show in search engines” in the SEO section of the settings.
+![An ecommerce storefront settings menu](/docs/images/user/quickstart/16-storefront-settings.png)
-To learn more about Storefront Settings, please refer to a separate support article.
+In **Storefront → Settings**, you can control:
-### New Store
+- SEO settings, including search engine indexing preferences
+- Favicon and social share images
+- Social media links
+- Custom code snippets to add to head and body tags
+- Storefront password protection preferences
-If you’d like to add multiple storefronts with completely different user experiences, product offerings, payment methods, etc., you can easily add a new store by clicking on the store name in the top left corner, and selecting New Store from the dropdown.
+Make sure to click **Update** to save your changes.
-<img
- alt="Add A New Store"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327029/docs/Getting%20Started/1.27_Getting_Started_-_Add_A_New_Store_mrbisv.png"
-/>
+<Note>To appear in search results, make sure **Index in search engines** is checked.</Note>
-The popup that appears will ask you to give the new store a name, select the country and currency, and to select whether or not to import products and payment methods from the original store.
+## Managing Multiple Stores
-<img
- alt="Configure New Store Settings"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327029/docs/Getting%20Started/1.28_Getting_Started_-_Configure_New_Store_Settings_p7mwlb.png"
-/>
+![Spree multi-store ecommerce](/docs/images/user/quickstart/17-multi-store.png)
-To learn more about the multi-store feature, please refer to a separate support article.
+If you need to launch multiple storefronts (e.g., for different regions or brands), you can create a new store by clicking the **\+** button next to your store name (top-left) and selecting **New Store**.
-## Home Screen
+![Adding a new store in Spree Commerce](/docs/images/user/quickstart/18-new-store.png)
-The home screen gives you an overview of your stores results over a time period of your choosing.
+You’ll be asked to:
-It highlights some important sales KPIs and visitor metrics so you can see how business is going at a glance.
+- Name the store
+- Choose a country, currency, and locale
+- Decide whether to import products and payment methods from the current store
-<img
- alt="Home Screen"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327030/docs/Getting%20Started/1.29_Getting_Started_-_Home_Screen_pehjal.png"
-/>
+Each store can operate independently and have unique designs, catalogs, and settings, but they all share customers, admin users, and some other configurations.
-### Key Sales KPIs
+Learn more about managing multiple stores in our [<u>multi-store use case documentation</u>](https://spreecommerce.org/docs/use-case/multi-store/model).
-At the top of the page, there’s a chart that depicts some of the key sales KPIs over the defined time period.
+## Analytics
-You change the time period by clicking on the date and then selecting the desired dates.
+![Spree Commerce dashboard analytics](/docs/images/user/quickstart/19-home-screen.png)
-<img
- alt="Sales KPIs"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327030/docs/Getting%20Started/1.30_Getting_Started_-_Sales_KPIs_pevyhk.png"
-/>
+Your Spree dashboard Home tab gives you high-level insights into store performance. 
-### Top products
+You’ll see:
-Below the KPIs, you’ll see a section that shows a list of the top selling products, with the option to view the full report.
+- Key Sales KPIs for revenue, orders, AOV and sign-ups
+- A list of top selling products over the selected time range
-<img
- alt="Top_Products"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327030/docs/Getting%20Started/1.31_Getting_Started_-_Top_Products_r37mpk.png"
-/>
+Use the date selector to change the reporting period at any time.
-### Visitor Data
+Similarly, you can view and export sales reports from the Reports tab:
-At the bottom of the page, there are four sections that provide data on your audience, specifically:
+![Spree Commerce native reports](/docs/images/user/quickstart/20-reports.png)
-- Referral site
-- Top landing pages
-- Visitor location
-- Visitor devices
+### 3rd Party Tools
-<img
- alt="Visitor_Data"
- classname="block dark:hidden"
- src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733327030/docs/Getting%20Started/1.32_Getting_Started_-_Visitor_Data_pugv5j.png"
-/>
+For more detailed analytics, we recommend using our native [<u>Google Analytics 4</u>](https://spreecommerce.org/docs/integrations/analytics/google-analytics) or [<u>Google Tag Manager</u>](https://spreecommerce.org/docs/integrations/analytics/google-tag-manager) integration.
-### Google Analytics
+## Next Steps
-For more detailed analytics, we recommend setting up Google Analytics or whichever analytics tool you prefer.
+Once you’ve completed the basic setup, you’re ready to explore more advanced features and tailor your store to your business model. Here’s some recommended reading:
-Spree Enterprise Edition comes with pre-built GA4 and Segment integration.
\ No newline at end of file
+- [**<u>Learn how to manage orders</u>**](https://spreecommerce.org/docs/user/orders/processing-orders) - process payments, fulfill shipments, create and edit orders
+- [**<u>Learn how to process returns</u>**](https://spreecommerce.org/docs/user/returns/returns-processing) - configure returns flow, authorize returns, reimburse customers
+- [**<u>Explore multi-store setups</u>**](https://spreecommerce.org/docs/use-case/multi-store/model) - run separate storefronts with unique catalogs, domains, and branding
+- [**<u>Launch a B2B storefront</u>**](https://spreecommerce.org/docs/use-case/b2b/b2b-commerce-model) - offer net terms, tiered pricing, company accounts, and purchase flows optimized for wholesale
+- [**<u>Build a multi-vendor marketplace</u>**](https://spreecommerce.org/docs/use-case/marketplace/model) - invite third-party vendors to sell through your platform
+- [**<u>Create a multi-tenant platform</u>**](https://spreecommerce.org/docs/use-case/multi-tenant/multi-tenant-model)  power multiple stores or clients from a single backend
+- [**<u>Sell digital products</u>**](https://spreecommerce.org/docs/use-case/digital-products/model) - deliver files automatically, skip shipping steps, and disable inventory tracking