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.

Documentation edits made through Mintlify web editor

mintlify[bot]9b270737896b
diff --git a/docs/user/customers/create-customer.mdx b/docs/user/customers/create-customer.mdx
index 2e3f50807e..20a32880d2 100644
--- a/docs/user/customers/create-customer.mdx
+++ b/docs/user/customers/create-customer.mdx
@@ -1,6 +1,6 @@
---
title: "Create a Customer"
-description: "You might want to create customers manually when processing phone or in-person orders or when migrating data from another platform."
+description: "In this user doc you'll learn how to create new customers in Spree as an admin."
---
Depending on your business model, you might want to create customers manually when processing phone or in-person orders or when migrating data from another platform. 
@@ -9,17 +9,17 @@ This ensures all customer details are accurately recorded in the system, allowin
To create a customer, navigate to the Customers tab of the admin dashboard.
-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647964/docs/Customers/Create%20a%20Customer/5.1.1_Create_A_Customer_-_Navigate_To_Tab_jogabv.png" />
+<img alt="Create a Customer" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647964/docs/Customers/Create%20a%20Customer/5.1.1_Create_A_Customer_-_Navigate_To_Tab_jogabv.png" />
Click on the ‘\+ Create Customer’ in the top right corner to open the customer creation form.
-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647965/docs/Customers/Create%20a%20Customer/5.1.2_Create_A_Customer_-_Customer_Creation_Form_yvvpqn.png" />
+<img alt="Create a Customer" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647965/docs/Customers/Create%20a%20Customer/5.1.2_Create_A_Customer_-_Customer_Creation_Form_yvvpqn.png" />
Simply type in the customers details (only an email address is required) and click ‘Create’ and you’ll be redirected to the newly created customers admin page.
Tip: Add customer tags like "VIP," "Frequent Buyer," or "Wholesale" to categorize customers based on purchasing behavior or status. Other tags such as "New Customer," "Flagged for Review," or "High-Value" can help streamline marketing efforts, customer service, and order management.
-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647964/docs/Customers/Create%20a%20Customer/5.1.3_Create_A_Customer_-_Customer_Created_rixjst.png" />
+<img alt="Create a Customer" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647964/docs/Customers/Create%20a%20Customer/5.1.3_Create_A_Customer_-_Customer_Created_rixjst.png" />
Now that the customer has been created, you can add additional information such as the shipping and billing addresses.
@@ -27,21 +27,21 @@ Now that the customer has been created, you can add additional information such
To add a shipping address, click ‘\+ Add’ in the Shipping Address section. This will reveal a form that will allow you to input the customer address.
-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647964/docs/Customers/Create%20a%20Customer/5.1.4_Create_A_Customer_-_Shipping_Address_rjw28p.png" />
+<img alt="Create a Customer" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647964/docs/Customers/Create%20a%20Customer/5.1.4_Create_A_Customer_-_Shipping_Address_rjw28p.png" />
After entering the address, click create and the new shipping address will be saved.
-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647965/docs/Customers/Create%20a%20Customer/5.1.5_Create_A_Customer_-_Shipping_Address_Added_qpkgll.png" />
+<img alt="Create a Customer" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647965/docs/Customers/Create%20a%20Customer/5.1.5_Create_A_Customer_-_Shipping_Address_Added_qpkgll.png" />
## Add a Billing Address
By default, the billing address will be set to ‘Same as shipping address’, but you can enter a different address by clicking on ‘Edit’ in the billing address section, and selecting ‘Add New Address’.
-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647965/docs/Customers/Create%20a%20Customer/5.1.6_Create_A_Customer_-_Billing_Address_ao94w9.png" />
+<img alt="Create a Customer" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647965/docs/Customers/Create%20a%20Customer/5.1.6_Create_A_Customer_-_Billing_Address_ao94w9.png" />
This will reveal a form in the same way as described above. Simply enter the correct billing address and click ‘Create’ to save it.
-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647966/docs/Customers/Create%20a%20Customer/5.1.7_Create_A_Customer_-_Change_Billing_Address_jeuubb.png" />
+<img alt="Create a Customer" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747647966/docs/Customers/Create%20a%20Customer/5.1.7_Create_A_Customer_-_Change_Billing_Address_jeuubb.png" />
With this information added, the customer can now be added to manual orders at the click of a button.
diff --git a/docs/user/customers/customer-profile.mdx b/docs/user/customers/customer-profile.mdx
new file mode 100644
index 0000000000..8d1805aeda
--- /dev/null
+++ b/docs/user/customers/customer-profile.mdx
@@ -0,0 +1,72 @@
+---
+title: "Customer Profile Overview"
+description: "In this user doc, you'll learn how to access and interpret the Customer Profile Overview in the Spree admin panel."
+---
+
+The customer profile provides an overview view of each customer’s activity, helping you better understand their behavior and purchasing habits. 
+
+It is essential for tracking engagement through various means, allowing you to improve customer service and follow up on potential sales opportunities.
+
+To review a customer profile, navigate to the Customer tab of the admin dashboard.
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649227/docs/Customers/Customer%20Profile%20Overview/5.2.1_Customer_Profile_-_Navigate_To_Tab_qzxziv.png" />
+
+Find and click on the customer whose profile you’d like to review. This will open up the customer profile page.
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649231/docs/Customers/Customer%20Profile%20Overview/5.2.2_Customer_Profile_-_Open_Profile_Page_ijlotk.png" />
+
+Here you’ll see various sections containing data related to this customer. Let’s take a look at each of them.
+
+## User Analytics
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649227/docs/Customers/Customer%20Profile%20Overview/5.2.3_Customer_Profile_-_User_Analytics_udlgfw.png" />
+
+At the top of the page, you’ll notice an analytics section that provides some important metrics, specifically:
+
+- Total Amount Spent
+- Number of Orders
+- Average Order Value
+- Joined Date
+- Number of Visits
+
+## Last Order Placed
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649228/docs/Customers/Customer%20Profile%20Overview/5.2.4_Customer_Profile_-_Last_Order_Placed_z7awul.png" />
+
+As the name suggests, this section displays the details of the last order placed by the customer.
+
+Note: You can also view a list of all orders placed by the customer by clicking on ‘View all orders’ in the bottom right corner of the section. 
+
+## Timeline
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649228/docs/Customers/Customer%20Profile%20Overview/5.2.5_Customer_Profile_-_Timeline_hb6qdz.png" />
+
+The Timeline subsection displays all product and transaction related actions taken by the customer, such as viewing products, adds to cart, and checkout steps.
+
+## Orders
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649228/docs/Customers/Customer%20Profile%20Overview/5.2.6_Customer_Profile_-_Orders_x1ja2o.png" />
+
+The Orders subsection displays a list of all orders placed by the customer, with the ability to search and filter the orders within the Customer Profile.
+
+## Draft Orders
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649228/docs/Customers/Customer%20Profile%20Overview/5.2.7_Customer_Profile_-_Draft_Orders_l8enoa.png" />
+
+Draft Orders are orders that are yet to be completed by the customer, including abandoned carts, and admin-created orders that do not have payments attached to them yet.
+
+## Gift Cards
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649229/docs/Customers/Customer%20Profile%20Overview/5.2.8_Customer_Profile_-_Gift_Cards_afgs9g.png" />
+
+Here you can see a list of gift cards assigned to the customer, as well as the amount of credit used.
+
+To learn more about assigned gift cards, please refer to another support article.
+
+## Store Credits
+
+<img alt="Customer Profile" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747649230/docs/Customers/Customer%20Profile%20Overview/5.2.9_Customer_Profile_-_Store_Credit_bkkx3p.png" />
+
+Here you can see a list of any store credit that’s been assigned the customer, as well as store credit usage.
+
+To learn more about assigning store credits, please refer to another support article.
\ No newline at end of file