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.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
Updated 'Customer Profiles' user doc (#13605)
jaburghes8300a597cdbb
diff --git a/docs/images/user/customers/customer-profiles/1-customers-tab.png b/docs/images/user/customers/customer-profiles/1-customers-tab.pngnew file mode 100644index 0000000000..4ef983edb3Binary files /dev/null and b/docs/images/user/customers/customer-profiles/1-customers-tab.png differdiff --git a/docs/images/user/customers/customer-profiles/10-draft-orders.png b/docs/images/user/customers/customer-profiles/10-draft-orders.pngnew file mode 100644index 0000000000..778daf9e91Binary files /dev/null and b/docs/images/user/customers/customer-profiles/10-draft-orders.png differdiff --git a/docs/images/user/customers/customer-profiles/11-gift-cards.png b/docs/images/user/customers/customer-profiles/11-gift-cards.pngnew file mode 100644index 0000000000..23162e28faBinary files /dev/null and b/docs/images/user/customers/customer-profiles/11-gift-cards.png differdiff --git a/docs/images/user/customers/customer-profiles/12-store-credits.png b/docs/images/user/customers/customer-profiles/12-store-credits.pngnew file mode 100644index 0000000000..35dddcdb40Binary files /dev/null and b/docs/images/user/customers/customer-profiles/12-store-credits.png differdiff --git a/docs/images/user/customers/customer-profiles/2-customer-profile.png b/docs/images/user/customers/customer-profiles/2-customer-profile.pngnew file mode 100644index 0000000000..c5d705b594Binary files /dev/null and b/docs/images/user/customers/customer-profiles/2-customer-profile.png differdiff --git a/docs/images/user/customers/customer-profiles/3-user-analytics.png b/docs/images/user/customers/customer-profiles/3-user-analytics.pngnew file mode 100644index 0000000000..662ddf7e93Binary files /dev/null and b/docs/images/user/customers/customer-profiles/3-user-analytics.png differdiff --git a/docs/images/user/customers/customer-profiles/4-user-details.png b/docs/images/user/customers/customer-profiles/4-user-details.pngnew file mode 100644index 0000000000..86d7671466Binary files /dev/null and b/docs/images/user/customers/customer-profiles/4-user-details.png differdiff --git a/docs/images/user/customers/customer-profiles/5-shipping-address.png b/docs/images/user/customers/customer-profiles/5-shipping-address.pngnew file mode 100644index 0000000000..5aa5d81a81Binary files /dev/null and b/docs/images/user/customers/customer-profiles/5-shipping-address.png differdiff --git a/docs/images/user/customers/customer-profiles/6-billing-address.png b/docs/images/user/customers/customer-profiles/6-billing-address.pngnew file mode 100644index 0000000000..4e7be921beBinary files /dev/null and b/docs/images/user/customers/customer-profiles/6-billing-address.png differdiff --git a/docs/images/user/customers/customer-profiles/7-internal-note.png b/docs/images/user/customers/customer-profiles/7-internal-note.pngnew file mode 100644index 0000000000..d64eff4559Binary files /dev/null and b/docs/images/user/customers/customer-profiles/7-internal-note.png differdiff --git a/docs/images/user/customers/customer-profiles/8-last-order-placed.png b/docs/images/user/customers/customer-profiles/8-last-order-placed.pngnew file mode 100644index 0000000000..1b398303e4Binary files /dev/null and b/docs/images/user/customers/customer-profiles/8-last-order-placed.png differdiff --git a/docs/images/user/customers/customer-profiles/9-customer-orders.png b/docs/images/user/customers/customer-profiles/9-customer-orders.pngnew file mode 100644index 0000000000..8b2b745681Binary files /dev/null and b/docs/images/user/customers/customer-profiles/9-customer-orders.png differdiff --git a/docs/user/customers/customer-profile.mdx b/docs/user/customers/customer-profile.mdxindex 8d1805aeda..6890a1913f 100644--- a/docs/user/customers/customer-profile.mdx+++ b/docs/user/customers/customer-profile.mdx@@ -1,72 +1,142 @@----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."+title: "Customer Profiles"+description: "Learn how to access and interpret the Customer Profile in the Spree admin dashboard."----The customer profile provides an overview view of each customer’s activity, helping you better understand their behavior and purchasing habits.+The Customer Profile gives you a complete view of a customer’s activity, order history, and account details - all in one place. It helps you better understand purchasing behavior, identify high-value customers, and provide faster, more personalized support.-It is essential for tracking engagement through various means, allowing you to improve customer service and follow up on potential sales opportunities.+## Accessing a Customer Profile-To review a customer profile, navigate to the Customer tab of the admin dashboard.+To access a customer’s profile, navigate to **Customers** in 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.+Find the customer you’d like to review (use search and filters if needed), and click on the customer’s name to open their profile.-<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.+The profile page is divided into several sections, each providing important information about the customer.## 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:+At the top of the page, you’ll see a summary of key customer metrics:- Total Amount Spent- Number of Orders- Average Order Value-- Joined Date-- Number of Visits+- Store Credits+ - Shows the value of store credits the customer has available+ - You can assign store credits here by clicking **Add Store Credit**+- Created At date, i.e., when they became a customer-## Last Order Placed+These metrics give you a quick snapshot of the customer’s engagement and lifetime value.++## Details++++This section contains core account information, including:++- Email address+- Phone number+- First and last name+- Email marketing opt-in status+- Assigned [<u>Customer Groups</u>](https://spreecommerce.org/docs/user/customers/customer-groups)+- Customer tags++<Note>You can use **tags** and **customer groups** to segment customers for promotions, pricing rules, or internal organization.</Note>++## Addresses++### **Shipping Address**-<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.+This section displays the customer’s default shipping address.-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.+<Note>If a Google Maps API key is connected, a map preview with a pinned location will also be shown.</Note>-## Timeline+### **Billing Address**-<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.+Displays the billing address or indicates **“Same as shipping address”** if that option is selected.++## Internal Note++++The Internal Note section displays any notes added by admins related to the customer.++These notes are not visible to the customer and can be used to:++- Document special agreements or pricing arrangements+- Flag account concern+- Record support interactions+- Add context for other team members++Internal notes help ensure your team has the full picture when assisting the customer.++## Last Order Placed++++This section shows a summary of the most recent order placed by the customer.++You can click the order number (e.g., R394161122) to see the full order details page.## 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 full list of all completed orders associated with the customer.++You can:++- Search within the customer’s orders+- Apply filters+- Sort and select which columns to display-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.+This makes it easy to quickly find specific transactions.## 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.+Draft Orders include:++- Abandoned carts+- Admin-created orders that are not yet completed+- Orders without attached payments++This section is useful for following up on incomplete purchases or manually created orders.## 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.+Displays all gift cards assigned to the customer, including:-To learn more about assigned gift cards, please refer to another support article.+- Current balance+- Amount used+- Currency+- Status++For more information on issuing gift cards, please refer to our [<u>Issuing Gift Cards</u>](https://spreecommerce.org/docs/user/customers/issue-gift-card) 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" />+++Displays any store credit assigned to the customer, along with usage history.++Store credits are commonly used for refunds, loyalty rewards, or manual adjustments.++In more advanced use cases, store credits may function as the primary payment method - especially in B2B environments where companies maintain a prepaid balance or approved credit limit and settle invoices periodically.++To learn more about store credits, please refer to our [<u>Assigning Store Credits</u>](https://spreecommerce.org/docs/user/customers/assign-store-credits) article.-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+In summary, the Customer Profile gives you a centralized view of everything related to a customer - making it easier to support them, reward loyalty, and resolve issues quickly.