1. Documentation /
  2. Group Coupons

Group Coupons

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 top
Install and activate the WooCommerce Group Coupons plugin.

Setup and Configuration

↑ Back to top
The extension is basically setup-free and provides default settings that suit most sites.
If you have not already installed the free Groups membership plugin, we recommend to install and activate it, as it allows to use the advanced coupon settings related to group memberships.
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 top
Once 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 top
The 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. Coupon settings for groups

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 top
The 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 top
The 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 top
This 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 top
In 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 top
Here 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 top
This example shows the settings used for a coupon that can only be used by those who have the Customer role.

Coupons Overview

↑ Back to top
The 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.
Showing the WooCommerce Coupons administrative section with additional columns and filters added by the extension
The extension provides additional informational columns and filters related to groups and roles.
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.
Highlighting the extension's coupon filters related to groups and roles
The coupon group and coupon role filters allow to find coupons that impose group or role constraints.
Additional filters allow to search for coupons that have certain group or role constraints.

Displaying Pretty Coupons

↑ Back to top
You might also be interested in using the free WooCommerce Coupon Shortcodes plugin which provides additional shortcodes that can be used with your coupons. It allows you to render coupon information and show content based on the validity of coupons.
To display pretty coupons, the [group_coupons] shortcode is used. WooCommerce Group Coupons Showing Discount 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 supports red, green, yellow for built-in styles and other values for custom CSS rules
  • order_by : defaults to code, also accepts id
  • order : default to ASC, also accepts DESC
  • auto : defaults to no, whether coupons that are automatically applied should be included, use yes to include those
  • groups : defaults to yes, whether coupons that are limited to groups should be included, use no to disable
  • roles : defaults to yes, whether coupons that are limited to roles should be included, use no 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, use false 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 top
Default – 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 top
The 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.