Skip to content

Customer Groups

Customer groups are the core of wholesale pricing. Each group defines a discount that applies automatically to every product for customers in that group.

Creating a Customer Group

  1. Go to Wholesale > Customer Groups in the admin sidebar
  2. Click the Create button

Create Customer Group

Fill in these fields:

FieldRequiredWhat to enter
NameYesA descriptive name, e.g., "Gold Resellers"
DescriptionNoInternal notes, e.g., "Verified resellers with annual volume >$50K"
Discount TypeYesPercentage - discounts by %, or Fixed Amount - discounts by a dollar amount
Discount ValueYesThe discount number. Enter 20 for 20% off (percentage) or 10 for $10 off (fixed)
PriorityNoA number used when a customer is in multiple groups. Lower number = higher priority. Default: 0
Min Order QuantityNoMinimum total items in cart to check out. Leave at 0 for no minimum
Min Order ValueNoMinimum cart subtotal to check out, e.g., 500 for $500 minimum. Leave at 0 for no minimum
StatusYesPublished to activate, Draft to save without activating
  1. Click Save

How each discount type works

Percentage discount - Takes a percentage off each product's price:

  • 20% off a $100 product = $80
  • 20% off a $50 product = $40

Fixed amount discount - Takes a flat dollar amount off each product:

  • $10 off a $100 product = $90
  • $10 off a $50 product = $40

TIP

Percentage discounts are the most common choice. They scale with product prices and are easy for customers to understand.

Editing a Customer Group

  1. Go to Wholesale > Customer Groups
  2. Click the group name or the Edit button
  3. Change any fields
  4. Click Save

WARNING

Discount changes take effect immediately. All customers in that group will see updated prices on their next page load.

Deleting a Customer Group

  1. Go to Wholesale > Customer Groups
  2. Click the Delete button on the group row
  3. Confirm deletion

When you delete a group:

  • All customer assignments to that group are removed
  • Those customers lose wholesale pricing (unless they're in another group)
  • Pricing rules targeting that group stop working

Alternative: Deactivate instead of delete. Edit the group and change Status to Draft. The group's pricing stops applying, but you can reactivate it later.

Assigning Customers to a Group

There are two ways to assign a customer to a group:

Method 1: From the customer edit page

  1. Go to Ecommerce > Customers
  2. Click to edit a customer
  3. Find the Wholesale Groups field
  4. Select one or more groups from the dropdown
  5. Click Save

Customer Assignment

The customer will see wholesale prices immediately on their next login.

Method 2: By approving a wholesale application

When a customer applies at /wholesale/register on your site:

  1. Go to Wholesale > Applications
  2. Click to review the application
  3. Click Approve and select which group to assign them to
  4. The customer is automatically assigned

See Reviewing Wholesale Applications for details.

Checking Which Group a Customer Is In

  1. Go to Ecommerce > Customers
  2. Edit the customer
  3. Look at the Wholesale Groups field - it shows all assigned groups

Removing a Customer from a Group

  1. Go to Ecommerce > Customers
  2. Edit the customer
  3. Clear the selection in the Wholesale Groups field
  4. Click Save

The customer reverts to retail pricing immediately.

Multiple Groups

If Allow Customers in Multiple Groups is enabled in Settings, a customer can belong to more than one group.

When a customer is in multiple groups with different discounts, the Discount Resolution Strategy determines which applies:

StrategyExample: Customer in Gold (20% off) + Silver (15% off)
HighestGets 20% off (the better discount)
LowestGets 15% off
PriorityGroup with lower priority number wins

Priority field

The Priority field on each group is only used when the resolution strategy is set to "Priority". Lower numbers mean higher priority:

GroupPriorityDiscount
Platinum125%
Gold220%
Silver315%

If a customer is in both Gold (priority 2) and Silver (priority 3), Gold wins because 2 < 3.

Common Group Structures

Simple tiered structure

GroupDiscountMin Order ValueWho qualifies
Gold20%$1,000High-volume buyers
Silver15%$500Regular wholesale
Bronze10%$250Entry-level wholesale

By business type

GroupDiscountMin Order ValueWho qualifies
Distributors30%$5,000Regional distributors
Retailers20%$1,000Retail store owners
Resellers15%$500Online resellers

Troubleshooting

Customer doesn't see discounted prices

  1. Check the customer is assigned to a group: Ecommerce > Customers > Edit customer > Wholesale Groups field
  2. Check the group status is Published: Wholesale > Customer Groups
  3. Make sure the customer is logged in on the frontend
  4. Clear cache: Admin > Platform Administration > Cache management > Clear all CMS cache

Wrong discount is applied

  1. Check if the customer is in multiple groups: Ecommerce > Customers > Edit customer
  2. Check which resolution strategy is active: Wholesale > Settings > Discount Resolution Strategy
  3. Check if there are pricing rules on the product that override the group discount

Group discount doesn't apply to a specific product

  1. Check if the product has a pricing rule that overrides the group discount
  2. Check the product's visibility settings aren't restricting access