WooCommerce Group Coupons is an extension for WooCommerce, that allows to limit coupons by groups and roles. Automatically apply and restrict coupon validity for user groups. Offer exclusive, automatic and targeted discounts for your customers.
Requirements
↑ Back to top- To restrict coupons by role, no specific requirements need to be met.
- To restrict coupons by group, the free Groups membership plugin is required.
- To automatically assign users to groups based on product purchases, the WooCommerce Groups extension is recommended, but it is not a requirement for this extension’s features to be fully supported.
Installation
↑ Back to topInstall and activate the WooCommerce Group Coupons plugin.
Setup and Configuration
↑ Back to topThe extension is basically setup-free and provides default settings that suit most sites.
A new menu item WooCommerce > Group Coupons gives access to several options that can be adjusted:
- Automatic group coupons – Enables options to apply coupons automatically based on group memberships with the free Groups membership plugin.
- Coupon error message – Allows to customize the notice shown when a customer tries to apply a coupon code which is restricted to a group to which the user does not belong.
- Roles – Enables coupon restriction options by WordPress user role.
- Logout – This provides an option to completely remove any coupons applied to a cart after a user logs out.
New Coupon Settings
↑ Back to topOnce the plugin is installed and activated, coupons will show additional settings under Coupon data.
- A new subsection related to Groups
- A second subsection for Roles
The subsection related to Groups allows to limit the coupon to be used only by members of one or more groups, to apply the coupon automatically to members of one or more groups and to exclude one or more groups from being able to use the coupon.
The second new subsection related to roles allows to limit the coupon to be used only by users that have one ore more roles.
New Coupon Settings for Groups
↑ Back to topThe Groups subsection of the settings under Coupon data allows to limit the coupon to groups, apply it automatically to groups and to exclude certain groups from using it. You can access these sections when you add a new coupon or edit an existing coupon.
Groups – limit the coupon to group members
Only members of the selected groups will be allowed to use the coupon. If no group is selected, the coupon is not restricted to any group members.
Automatic application – apply the coupon to group members automatically
The coupon will be applied automatically to members of any of the selected groups.
It’s important to note that this does not limit the coupon to group members, anyone could use the coupon – it will just not be applied to anyone automatically. If the coupon should only be available to members of the selected groups, you must also limit the coupon to these groups.
Exclude Groups – exclude group members from using this coupon
Members of the groups chosen here will not be allowed to use the coupon.
New Coupon Settings for Roles
↑ Back to topThe Roles subsection of the settings under Coupon data allows to limit the coupon to certain roles. You can access this section when you add a new coupon or edit an existing coupon.
Roles – limit the coupon to roles
Only users who have one of the selected roles will be allowed to use the coupon. If no role is selected, the coupon is not restricted to any roles. It’s worth noting that for example an Administrator will not be allowed to use a coupon that is restricted to a Contributor and vice-versa. If you want several roles to be able to use the coupon, you must check each role here.
Exclude Roles – exclude roles from using this coupon
Users with the chosen roles will not be allowed to use the coupon.
Examples
↑ Back to topThe following examples illustrate some cases and configurations where a coupon is limited or applied automatically based on groups or roles.
If you are not familiar with the Groups membership plugin yet, we recommend to review its documentation pages where you can quickly learn how to create a group and assign users to it. In the following examples, we will be using several groups with intuitive names. Please note that the Registered group already exists when you install the Groups membership plugin and that all users belong to it.
A restricted Coupon for Registered Users
↑ Back to topThis example shows the settings used for a coupon that is limited to registered users and applied automatically for them. This means that the coupon will be applied automatically for any existing user account, without the need for the customer to input the coupon code at checkout explicitly. In this example, we also exclude any member of the Test group from using the coupon.
An automatic Coupon for Distributors
↑ Back to topIn this example you can see the settings used for a coupon that is limited and applied automatically for two distributor groups.
A Coupon limited to certain Groups
↑ Back to topHere we have an example with settings for a coupon that is restricted to two groups, Level 1 and Level 2.
A Coupon limited to Customers
↑ Back to topThis example shows the settings used for a coupon that can only be used by those who have the Customer role.
Coupons Overview
↑ Back to topThe limiting groups, groups for which coupons are applied automatically and limiting roles are displayed in the Coupons section under Marketing > Coupons (previously under WooCommerce > Coupons) on your WordPress dashboard.

The additional columns Groups, Auto and Roles show if coupons are restricted to members of certain groups, if they are applied automatically to certain groups or if they are restricted to certain roles.

Additional filters allow to search for coupons that have certain group or role constraints.
Displaying Pretty Coupons
↑ Back to topTo display pretty coupons, the [group_coupons]
shortcode is used.
Use the shortcode by embedding it on a page where you want to show the coupons handled by the extension to your customers.
Coupons are displayed when valid (validity is based on the user account, coupon settings and the shortcode settings).
Shortcode attributes
↑ Back to top- color : defaults to
blue
, also supportsred
,green
,yellow
for built-in styles and other values for custom CSS rules - order_by : defaults to
code
, also acceptsid
- order : default to
ASC
, also acceptsDESC
- auto : defaults to
no
, whether coupons that are automatically applied should be included, useyes
to include those - groups : defaults to
yes
, whether coupons that are limited to groups should be included, useno
to disable - roles : defaults to
yes
, whether coupons that are limited to roles should be included, useno
to disable - show_cart_invalid : defaults to
true
, coupons that require cart conditions to be valid should be included although the current cart does not meet those conditions, usefalse
to disable - stylesheet : indicate a URL to load a custom stylesheet, when empty will not load a stylesheet, defaults to
null
and loads the stylesheet with built-in styles - show_discount : By default, coupons show the type of discount. Use
show_discount="no"
to disable that.
Examples
↑ Back to topDefault – The default version will display coupon codes that are valid based on the user’s group memberships and roles:
[group_coupons]
Only auto – To only display coupons that are applied automatically:
[group_coupons auto="yes" groups="no" roles="no"]
Only roles – To display coupons that are valid for the user based on roles only:
[group_coupons auto="no" groups="no" roles="yes"]
All group coupons – To display coupons that are valid for the user based on groups and roles:
[group_coupons auto="yes" groups="yes" roles="yes"]
Translations
↑ Back to topThe extension includes some translations and a translation template which you can use to create your own translation as needed. The extension uses flexible language translation which will use a language-generic translation if no country-specific translation is available (this can be disabled by setting the WGC_STRICT_LOCALE
constant to true
in your site’s wp-config.php
). For example, although there are several formal and informal translations for the German language and several countries, the included translation is a generic one for the German language in general. The translation files included in the extension’s languages
folder for the German language are woocommerce-group-coupons-de.po
and woocommerce-group-coupons-de.mo
and those will be used unless a country-specific translation is encountered.
Questions & Support
↑ Back to top- Have a question before you buy? Please fill out this pre-sales form.
- Already purchased and need some assistance? Open an ticket via the Help Desk.