docs/user/customers/customer-groups.mdx
Customer Groups let you segment your customers into defined lists, which can then be used to personalize pricing, limit access to promotions, or power other business rules.
On their own, groups are just lists. The value comes from what you attach to them — and how Spree uses group membership to automatically personalise what each buyer sees.
Pricing tiers — By pairing a customer group with a <u>Price List</u>, every member of that group automatically sees their correct prices the moment they log in. The Price List can override base prices across your entire catalog, or just on specific products. You can have as many groups and price lists as you need — one per customer tier, one per named account, or one per region — and Spree applies the right one without any manual work. When you add a new customer to a group, they inherit the pricing immediately.
Exclusive promotions — Promotion rules can be restricted to specific customer groups, so a discount code or automatic offer only applies to the customers it's meant for. Useful for loyalty rewards, trade-only offers, or onboarding incentives for new wholesale accounts.
Single storefront, multiple experiences — Because pricing and promotions are tied to the buyer's account rather than to separate stores or URLs, retail and trade customers can shop side by side on the same storefront. Public visitors see standard prices; logged-in trade buyers see theirs. No duplicate stores to maintain, no separate login portals to manage.
An industrial supplier runs three buyer types from a single storefront:
Each group has its own Price List. When a buyer logs in, Spree checks their group membership and applies the correct prices automatically.
<Note>For a full walkthrough of this setup, see <u>Set Up Wholesale Pricing</u>.</Note>
To create a new customer group, navigate to Customers → Customer Groups in the admin dashboard.
Here you'll see an overview of all existing customer groups, including the number of customers in each.
Click the New Customer Group button in the top right to begin setup.
In the creation form, add:
Click Create to save the new group.
Once the group is created, you'll be taken to its detail view.
To add customers to the group, click the Add Customers button, and a side panel will open where you can search and select customers to add.
Check the boxes next to the customers you want to add, then click Add Selected.
That's all there is to it — your customer group is now ready to use in price lists, promotions, and more.
To remove customers from a group, select the checkboxes next to the customers you want to remove, then click Remove from Group in the actions menu at the bottom of the screen.