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 'Searching customers' user doc (#13617)

jaburghesd21e91eb5adb
diff --git a/docs/images/user/customers/searching-customers/1-customers-tab.png b/docs/images/user/customers/searching-customers/1-customers-tab.png
new file mode 100644
index 0000000000..ca1243b604
Binary files /dev/null and b/docs/images/user/customers/searching-customers/1-customers-tab.png differ
diff --git a/docs/images/user/customers/searching-customers/2-search-bar.png b/docs/images/user/customers/searching-customers/2-search-bar.png
new file mode 100644
index 0000000000..4adbcd835a
Binary files /dev/null and b/docs/images/user/customers/searching-customers/2-search-bar.png differ
diff --git a/docs/images/user/customers/searching-customers/3-sort-by.png b/docs/images/user/customers/searching-customers/3-sort-by.png
new file mode 100644
index 0000000000..4043460b06
Binary files /dev/null and b/docs/images/user/customers/searching-customers/3-sort-by.png differ
diff --git a/docs/images/user/customers/searching-customers/4-select-columns.png b/docs/images/user/customers/searching-customers/4-select-columns.png
new file mode 100644
index 0000000000..06b4c6b33e
Binary files /dev/null and b/docs/images/user/customers/searching-customers/4-select-columns.png differ
diff --git a/docs/images/user/customers/searching-customers/5-filters.png b/docs/images/user/customers/searching-customers/5-filters.png
new file mode 100644
index 0000000000..2d66e51f6e
Binary files /dev/null and b/docs/images/user/customers/searching-customers/5-filters.png differ
diff --git a/docs/user/customers/searching-customers.mdx b/docs/user/customers/searching-customers.mdx
index 69a5cfaf62..835a6df75e 100644
--- a/docs/user/customers/searching-customers.mdx
+++ b/docs/user/customers/searching-customers.mdx
@@ -1,34 +1,77 @@
---
title: "Searching Customers"
-description: "In this user doc, you'll learn about various methods to search for customers in Spree."
+description: "Learn how to search for customers in the Spree admin dashboard."
---
-Being able to effectively search for customers is important for quickly locating specific profiles, especially during customer service interactions or order inquiries. It can also help you efficiently update details, review purchase history, or manage tags to improve personalized service and marketing efforts.
+Quickly finding the right customer is essential for providing efficient support, reviewing order history, updating account details, or managing marketing preferences.
-To search for customers, navigate to the Customers tab of the admin dashboard.
+Spree’s updated table view makes it easy to search, sort, and filter customer records with precision.
-<img alt="Searching Customers" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747661006/docs/Customers/Searching%20Customers/5.4.1_Searching_Customers_-_Navigate_To_Tab_jjjb2k.png" />
+## How to Search for Customers
-Above the customer list, you’ll notice a search bar and some filtering options.
+To search for customers, navigate to **Customers** in the admin dashboard.
-## Search
+![How to search for customers in Spree Commerce](/docs/images/user/customers/searching-customers/1-customers-tab.png)
-The search bar is the most efficient way to find a customer when you know their email address or full name.
+At the top of the page, you’ll find the search bar along with sorting, column, and filter controls.
+
+## Search Bar
+
+![Using the search bar to find customers in Spree Commerce](/docs/images/user/customers/searching-customers/2-search-bar.png)
+
+Use the search bar to quickly locate a customer by:
+
+- Email address
+- First name
+- Last name
+
+Results update based on your query, helping you find specific profiles instantly.
+
+## Sorting & Columns
+
+The new table interface allows you to customize how customer data is displayed.
+
+### **Sort**
+
+![Sorting the customer table in Spree Commerce](/docs/images/user/customers/searching-customers/3-sort-by.png)
+
+Click on the **Sort by** dropdown to select the field you like to sort by, and select whether you’d like the results to be in ascending or descending order.
+
+### **Columns**
+
+![Configuring columns on the customer table in Spree Commerce](/docs/images/user/customers/searching-customers/4-select-columns.png)
+
+Use the column selector to choose which fields are visible in your table view. This allows you to tailor the layout based on what information is most relevant to your workflow.
## Filters
-Filters help refine your search and are especially useful when exporting customer lists.
+![Applying filters to the customer table in the Spree admin dashboard](/docs/images/user/customers/searching-customers/5-filters.png)
-To access filtering options, click the ‘Filters’ button next to the search bar.
+For more advanced searches, click **Filters** to build custom filter rules.
-<img alt="Searching Customers" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1747661005/docs/Customers/Searching%20Customers/5.4.2_Searching_Customers_-_Filters_fsaypa.png" />
+You can create filter groups using **AND** / **OR** logic and apply conditions using the following operators:
-You can narrow your results using the following filters:
+- equals
+- does not equal
+- greater than
+- greater than or equal
+- less than
+- less than or equal
+- is any of
+- is none of
+- is empty
+- is not empty
+### **Available Filter Fields**
+
+You can filter customers by:
+
+- Email marketing (opted in or not)
+- Location
+- Created at
+- Updated at
- First Name
- Last Name
-- Location
- Tags
-- Accept Email Marketing
-Note: You can apply multiple filters at the same time to further refine your search.
\ No newline at end of file
+Multiple filters can be combined to narrow down results - for example, finding customers who have opted into email marketing and were created within a specific timeframe.