githubEdit

Customer Groups

Guide to creating and managing customer groups in OpenCart 4

circle-info

Organizing Your Customers Customer Groups allow you to categorize customers for targeted marketing, special pricing, and permission management in OpenCart 4.

Introduction

Customer Groups in OpenCart 4 enable you to organize customers into logical categories. This powerful feature allows you to apply different settings, pricing, and permissions to different groups of customers, making it ideal for businesses that serve multiple customer segments.

Default Customer Groups

OpenCart 4 comes with three default customer groups:

Group
Description
Typical Use

Default

Standard customer group

Regular retail customers

Retail

Retail customers

General public shoppers

Wholesale

Wholesale/business customers

B2B customers with special pricing

circle-check

Accessing Customer Groups

To access the Customer Groups interface:

  1. Log in to your OpenCart admin panel

  2. Navigate to Customers → Customer Groups

  3. You'll see the customer group list with existing groups

Customer Groups List

Creating a New Customer Group

1

Step 1: Click Add New

Click the Add New button (+) in the top-right corner of the customer group list.

Figura 2: Add New button in customer groups list

2

Step 2: Configure Group Settings

Fill in the group configuration form:

General Settings

circle-info

Group Name & Description 📝

  • Group Name: Required, 3-32 characters per language, multilingual support

  • Description: Optional internal notes for admin reference only

Approval Settings

circle-exclamation

Display Settings

circle-check
Customer Group Form
3

Step 3: Save the Group

Click Save to create the new customer group. You'll see a success message confirming the group has been created.

Editing an Existing Customer Group

To edit an existing customer group:

  1. From the customer group list, click the Edit button (pencil icon) next to the group

  2. Make your changes in the group form

  3. Click Save to update the group settings

circle-exclamation

Group Configuration Details

chevron-rightGroup Namehashtag
  • Required: Yes

  • Length: 3-32 characters per language

  • Multilingual: Supports multiple languages for international stores

chevron-rightDescriptionhashtag
  • Required: No

  • Purpose: Internal notes about the group's purpose

  • Visibility: Not shown to customers, for admin reference only

chevron-rightApproval Requiredhashtag

This setting controls whether new customer registrations in this group require manual approval:

Setting
Behavior
Use Case

Yes

Admin must manually approve each new registration

High-security stores, B2B portals, exclusive memberships

No

Automatic approval upon registration

Standard retail stores, public websites

Approval Required Setting

Figura 4: Approval Required setting in customer group configuration

chevron-rightSort Orderhashtag
  • Purpose: Controls display order in dropdown menus

  • Lower numbers: Appear first in lists

  • Default: 0 for default groups

Use Cases for Customer Groups

chevron-right1. Retail vs Wholesale Pricing 🛍️hashtag

Create separate groups for retail and wholesale customers with different pricing rules:

  • Retail Group: Standard pricing, no approval required

  • Wholesale Group: Special pricing, approval required for new accounts

chevron-right2. Geographic Segmentation 🌍hashtag

Create groups for customers in different regions or countries:

  • Domestic Customers: Standard shipping rates

  • International Customers: Higher shipping rates, different tax rules

chevron-right3. Customer Tier System 🥇hashtag

Implement loyalty tiers based on purchase history:

  • Bronze: New customers, basic benefits

  • Silver: Regular customers, enhanced benefits

  • Gold: VIP customers, premium benefits

chevron-right4. Business Customer Management 🏢hashtag

Special groups for business customers:

  • Corporate Accounts: Company-specific pricing, approval required

  • Government Accounts: Special terms, documentation requirements

Assigning Customers to Groups

chevron-rightDuring Registration 📝hashtag

Customers select their group during registration (if multiple groups are available and don't require approval).

chevron-rightManual Assignment 👤hashtag

Admins can assign customers to groups:

  1. Go to Customers → Customers

  2. Edit a customer

  3. Change the Customer Group in the General tab

  4. Save the changes

Integration with Other Features

chevron-rightCustom Fields 📝hashtag

Customer groups determine which custom fields are shown during registration and in customer profiles:

  1. Create custom fields in Customers → Custom Fields

  2. Assign fields to specific customer groups

  3. Fields only appear for customers in those groups

chevron-rightPricing Rules 💰hashtag

Use customer groups with special pricing extensions to offer group-specific pricing.

chevron-rightMarketing Campaigns 📧hashtag

Target email campaigns and promotions to specific customer groups.

chevron-rightPermission Management 🔒hashtag

Control access to certain store features based on customer group membership.

Best Practices

circle-check
circle-exclamation
circle-info

Group Maintenance 🛠️

  1. Regular Review: Periodically review group assignments and settings

  2. Clean Up: Remove unused groups to simplify management

  3. Documentation: Keep notes on group purposes and rules

Troubleshooting

Common Issues

chevron-rightGroup not appearing in registration 🔍hashtag

Solution: Check group settings: Approval Required should be "No" for self-selection

chevron-rightCannot delete group 🗑️hashtag

Solution: Ensure no customers are assigned to the group. Reassign customers first

chevron-rightCustom fields not showing 📝hashtag

Solution: Verify custom fields are assigned to the correct customer groups

chevron-rightApproval emails not sending 📧hashtag

Solution: Check email configuration and notification settings

circle-info

Performance Considerations

  • Large numbers of customer groups can slow down registration and admin interfaces

  • Consider using extensions for advanced group management if you need many groups

  • Regularly clean up inactive groups and customer assignments

circle-check

Last updated