> ## Documentation Index
> Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Groups

> Learn to how to set up customer groups in Spree Commerce.

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.

They’re especially useful when used with:

* **Price List Rules** - apply custom pricing to specific customer groups.
* **Promotion Rules** - restrict eligibility to certain customer segments (e.g. wholesale, VIP, B2B).

## Create a Customer Group

To create a new customer group, navigate to **Customers → Customer Groups** in the admin dashboard.

<img src="https://mintcdn.com/spreecommerce/O3iCuG-Bw62vWUMR/images/user/customers/customer-groups/1-customer-groups.png?fit=max&auto=format&n=O3iCuG-Bw62vWUMR&q=85&s=0be24d59d6e72e2d9b965f94b61919cc" alt="The Customer Groups tab in Spree Commerce" width="3060" height="1454" data-path="images/user/customers/customer-groups/1-customer-groups.png" />

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.

## Add Group Details

<img src="https://mintcdn.com/spreecommerce/O3iCuG-Bw62vWUMR/images/user/customers/customer-groups/2-customer-group-form.png?fit=max&auto=format&n=O3iCuG-Bw62vWUMR&q=85&s=323066a542a4a3d0746e3bc0222573d2" alt="Adding a new customer group in Spree Commerce" width="3060" height="1454" data-path="images/user/customers/customer-groups/2-customer-group-form.png" />

In the creation form, add:

* Name - This is how the group will appear in admin interfaces
* Description - Use this field to describe the purpose of the group, e.g. “North America wholesale buyers” or “Early access testers” (optional)

Click **Create** to save the new group.

## Add Customers to the Group

<img src="https://mintcdn.com/spreecommerce/O3iCuG-Bw62vWUMR/images/user/customers/customer-groups/3-customer-group-edit.png?fit=max&auto=format&n=O3iCuG-Bw62vWUMR&q=85&s=a24873b949093e8c85ed9a2a12fb7207" alt="Customer group overview in Spree Commerce" width="3060" height="1454" data-path="images/user/customers/customer-groups/3-customer-group-edit.png" />

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.

<img src="https://mintcdn.com/spreecommerce/O3iCuG-Bw62vWUMR/images/user/customers/customer-groups/4-add-customers.png?fit=max&auto=format&n=O3iCuG-Bw62vWUMR&q=85&s=fcc81ad2a04baa126fe1f9b0986d83d7" alt="Adding customers to a customer group in Spree Commerce" width="3060" height="1848" data-path="images/user/customers/customer-groups/4-add-customers.png" />

Check the boxes next to the customers you want to add, then click **Add Selected**.

<img src="https://mintcdn.com/spreecommerce/O3iCuG-Bw62vWUMR/images/user/customers/customer-groups/5-customers-added.png?fit=max&auto=format&n=O3iCuG-Bw62vWUMR&q=85&s=67eec7a8e0f45eedc809eff31b9c864a" alt="An active customer group in Spree Commerce" width="3060" height="1612" data-path="images/user/customers/customer-groups/5-customers-added.png" />

That’s all there is to it - your customer group is now ready to use in promotions, price lists, and more.

## Remove Customers from a Group

To remove customers from a group, simply 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.
