Promotions & Discount Codes Add-on

The Promotions add-on for Event Espresso 4 adds powerful and flexible promotional pricing features to your website. You can now create discount codes and promotions that can be applied when registering for an event and/or individual ticket among several ticket options for the same event.


This gives the person registering the ability to apply a discount code, or receive an automated discount that reduces the price of a registration.

Overview

This add-on’s basic features include:

  • Promotional pricing discount codes
  • Promotional pricing without discount codes
  • Create a global promotion code and assign to several events
  • Optional usage quantity limits per discount
  • Optional start and expiration date for each discount
  • Percentage or fixed discounts
  • A shortcode and a widget that display a list of non-coded promotions on your website
  • A fixed discount, for example "save $15 with this code".
  • A percent discount, for example "save 20% with this code".
  • A discount for a limited time only.
  • A discount on one ticket type only, for example "10% off the VIP ticket".
  • A discount on the whole order, for example "$20 off any order for these three workshops".
  • A discount that needs a minimum order, for example "10% off orders of $500 or more".
  • A "buy this, get that" discount, for example "15% off the dinner ticket when you also buy a conference pass".
  • A volume discount that grows with the order, for example "10% off 5 or more tickets, 15% off 10 or more, 20% off 20 or more".

You can also limit a promotion to a date range, to a number of uses, or to specific events or tickets.

Need to Buy a Support License for the Promotions Add-on for Event Espresso 4?

https://eventespresso.com/product/eea-promotions/

The Promotions add-on is included in the EE4 Everything Support License.


Installation

This add-on is a plugin for WordPress and can be installed through your WP dashboard (WP-admin).

You download the latest version of the Promotions add-on from your Event Espresso account page.

  • Then log in to your  WordPress dashboard (WP-admin) and go to Plugins.
  • Next, click on Add New –> Upload and browse to the plugin on your computer.
  • Then select the zip file and begin the upload process. Wait for the plugin to upload and then click on Activate.

Setup and Configuration

You can access the Settings page by going to Event Espresso > Promotions and click the Settings tab.


Promotions & Tax Calculations

The first setting is  very important if you set taxes on your tickets. In some locales the tax needs to be applied to the the price pre-discount, in other locales the tax needs to be applied to the discounted price.

The other settings are for changing how non-coded promotions are displayed.

You can display a list of non-coded promotions on your website by activating the Promotions widget in WP > Appearance > Widgets. Alternatively you can place the [ESPRESSO_PROMOTIONS] shortcode on a page and it will display upcoming promotions there.

Usage

Managing Promotions

Go to Event Espresso > Promotions. Click Add New to make a promotion, or click the name of a promotion to edit it.

The promotions list shows a short summary of each promotion:

  • Applies To shows an icon and what the promotion applies to: the event names, the number of tickets, or the whole order.
  • Amount shows the discount. For a promotion with tiers, it shows the highest tier too, for example "10% (up to 20%)".
  • A cart icon with the tooltip "Has cart conditions" marks a promotion that has conditions. Point at an icon to see what it means.

Promotion fields

  • Name: Use the name to identify the promotion. The name is not the discount code.
  • Code: Type the code that attendees enter at checkout. Leave this field empty for an automatic promotion.
  • Type: Choose Percent Discount or Dollar (fixed) Discount.
  • Amount: Type the discount amount.
  • Maximum discount (optional): Only for a percent discount. This is the most money the promotion can take off one order, in total. Leave it empty for no maximum. For example, "20% off, up to $50" gives $50 off, not $80, on a $400 order.
  • Higher tiers: See Volume discounts (tiers).
  • Applies to: Choose what the promotion discounts. See What a promotion applies to.
  • Conditions: Rules that the order must meet. See Conditions.
  • Promo Is Exclusive: Attendees cannot combine an exclusive promotion with any other coded promotion at checkout.
  • Total Number of Uses: The total number of times anyone can use the promotion. Leave it empty for no limit.
  • Number of Uses Per Event or Per Ticket: The number of uses for each chosen event or each chosen ticket. Leave it empty for no limit. For example, set it to 5 on a promotion for 2 events, and the promotion can be used 5 times for each event. This field does not show for The whole transaction option.
  • Valid From and Valid Until: The promotion starts and stops by itself on these dates.
  • Banner Text / Description: The text of the promotion banners (see the Settings tab), and of any list that shows the promotion.
  • Accepted Message: For a code. Attendees see this message when their code applies to their order.
  • Declined Message: For a code. Attendees see this message when their code does not apply to their order.

What a promotion applies to

Under Applies to, choose one of three options:


Option What it discounts Example
All tickets in the events I choose Every ticket of the chosen events. 10% off every ticket for the Spring Gala.
Only the tickets I choose Only the chosen tickets. Other tickets of the same event pay the full price. 10% off the VIP ticket only.
The whole transaction, if every event is one I choose The whole order, one time. The order gets the discount only if every event in it is a chosen event. $20 off an order for any mix of these three workshops.

More about "The whole transaction" option:

  • A fixed discount comes off one time for each order, not once for each ticket. For example, $20 off an order with 3 tickets gives $20 off.
  • A percent discount takes the percent of the whole order. For example, 10% off a $100 ticket and a $50 ticket gives $15 off.
  • If the order has a ticket for any event that you did not choose, the promotion gives no discount at all.
  • Each order that gets the discount counts as 1 use.
  • The total of an order never goes below $0.

Choose the events or the tickets

The list under Applies to shows your events, or your events and their tickets. Check the box next to each event or ticket that the promotion applies to.


  • Summary: The line above the list shows what you chose, for example "Applies to 3 tickets in 2 events".
  • Select all: For tickets, each event has a check box that selects or clears all its tickets.
  • Advanced Filters: Click the settings icon to show the filters. Search by name, set a date range, or filter by category.
  • Display only selected: Show only what you already chose.
  • Sort: Click sort to change the order of the list.
  • Pages: If the list is longer than one page, use the page links to see more.

Apply Promo to ALL Scope Items: Set this to Yes to apply the promotion to all events, without checking each one. This option is not available for Only the tickets I choose.


Note: After someone uses a promotion one time, you cannot change its Applies to option. You can still add or remove events and tickets. A ticket that already has a use of the promotion stays selected, and you cannot clear it.


Conditions

A condition is a rule that the order must meet before the promotion applies. The promotion applies only when the order meets every condition. To add one, click Add condition.


Condition What it checks Example
Minimum order amount The order total before tax is at least this amount. 10% off orders of $500 or more.
Minimum number of tickets The order has at least this number of tickets (2 or more). 10% off when the order has 4 or more tickets.
Required tickets The order also has the tickets that you choose. Choose all of them, or one or more of them. 15% off the dinner ticket when the order also has a conference pass.

For Minimum order amount and Minimum number of tickets, also choose what to count:

  • the discounted items: only the tickets that this promotion discounts.
  • the whole cart: every ticket in the order.

Extra settings for Required tickets. These show only for Only the tickets I choose.

  • Discount goes to:
    • chosen tickets only: only the chosen tickets get the discount. This is "buy this, get that off".
    • chosen and required tickets: both get the discount. This is a bundle.
  • One discounted ticket per set of required tickets: turn this on to limit the discount to one chosen ticket for each set of required tickets. For example, with 2 conference passes and 3 dinner tickets, only 2 dinner tickets get the discount.

When the order changes:

  • Event Espresso checks the conditions again each time the attendee changes the order.
  • If the order no longer meets a condition, the discount comes off. Event Espresso gives the use back to the promotion.
  • If the order meets the conditions again, the discount comes back by itself. The attendee does not need to enter the code again.
  • The discount does not come back if the promotion has no uses left. In this case, the attendee sees "This promotion has no uses left."

Volume discounts (tiers)

Tiers give a bigger discount for a bigger order. You can add up to 5 tiers under the Amount field. To add one, click Add a tier.


  1. In by, choose what the tiers count: number of tickets or pre-tax order amount.
  2. In counting, choose the discounted items or the whole cart.
  3. For each tier, type where it starts (From) and the discount of the tier.

Example: a 10% promotion with these tiers:


Tickets in the order Discount Example with $50 tickets
1 to 9 10% (the Amount) 5 tickets: $25 off
From 10 15% 10 tickets: $75 off
From 20 20% 25 tickets: $250 off

Rules for tiers:

  • When the order reaches a tier, that tier's discount applies to all the counted tickets, not only to the tickets above the threshold.
  • A tier has the same type as the promotion. A percent promotion has percent tiers, and a fixed promotion has fixed tiers.
  • Each tier must start higher than the tier before it and give a bigger discount. A percent tier is 100% or less.
  • The Maximum discount also limits the percent tiers.
  • Tiers work with all three Applies to options and with the conditions.

At checkout:

  • The discount line names the tier that applies.
  • If the order is close to the next tier, the payment step shows a short line, for example "Add 2 more tickets to get 15% off."
  • If you count the order amount, the line says "Add $120.00 more before tax to get 15% off." on a site with a tax.

Applying Promotions at Checkout

Automatic promotions apply to the prices at checkout by themselves. Attendees enter a promotion code on the payment step, where they choose how to pay.


The code field shows when the order has an event or a ticket that an active code promotion applies to.


If a code does not apply to the order, the attendee sees the Declined Message. For example:

  • The order does not have a chosen ticket.
  • The order has an event that the promotion does not apply to.
  • The order does not meet a condition.

If you edit an order in the admin, you can apply a promotion code to it from the transaction screen. The same rules apply as at checkout.


Viewing Applied Promotions

To see the promotion on an order, open the transaction from the transactions list in Event Espresso. Each registration with a promotion shows a price breakdown in its details.


The Registrations CSV report has a column that shows the promotion code of each order.


Duplicating a promotion

When you duplicate a promotion, the copy keeps its conditions, its maximum discount and its tiers.


Automatic promotions (no code)

A promotion with no code applies by itself at checkout when the order qualifies.


To show a list of these promotions on your website, do one of these:


  • Turn on the Promotions widget in WP > Appearance > Widgets.
  • Put the [ESPRESSO_PROMOTIONS]    shortcode on a page.

The list shows the upcoming promotions with:

  • what each promotion applies to: events, tickets or the whole order
  • its conditions, for example a minimum order
  • its higher tiers, if it has any

The list shows only tickets that the public can buy. It never shows hidden or members-only tickets.


Frequently Asked Questions

  • Can I make a promotion for one ticket type only?

    Yes. Under Applies to, choose Only the tickets I choose, then check the tickets.

  • Can I give a discount on the whole order instead of on each ticket?

    Yes. Under Applies to, choose The whole transaction, if every event is one I choose.

  • Can I give a bigger discount for bigger orders?

    Yes. Add tiers to the promotion. See Volume discounts (tiers).

  • Why did a discount disappear from the cart?

    The order no longer meets a condition of the promotion. For example, the attendee removed a ticket and the order fell below the minimum amount. If the order meets the condition again, the discount comes back by itself.

  • How do I change the color of the promotion code button?

    Your WordPress theme controls button colors, fonts and text styles. Change the color in the theme settings.

  • Can I import discount codes?

    Yes, a promotion code feature is available soon or


CSS classes for the promotion code field and button

Input field classes: ee-promotion-code-input ee-reg-qstn ee-promo-combo-input   


Submit button classes: button button-primary ee-promo-combo-submit   


Example CSS to style the promotion code button:


input.ee-promo-combo-submit {
background-color: green;
color: #fff;
}

To hide the promotion code field on the payment step, use this CSS:


#ee-promotion-code-input,
#ee-promotion-code-input-lbl,
#ee-promotion-code-submit {
    display:none!important;
}

To add custom CSS to your event website, go to your Event Espresso dashboard > Appearance > Customizer > Additional CSS. The Business plan includes this feature. On the Basic or Personal plan, add the Custom CSS upgrade.


Troubleshooting

  • The plugin will not activate. Can you help?

    Please first check that you have Event Espresso version 4.8 or greater installed.

Frequently Asked Questions

  • How do I change the color of the submit promo code button?

    As with most style oriented customizations, button colors, fonts, and text styles are all controlled by your WordPress theme. You can change the color using the theme’s settings (if included) or with CSS

  • How can I import discount codes?

    Yes a promotion code import is coming soon. Reach out to our support team for access or details.

Customizations

Our support team cannot write custom code for you.

CSS classes for the promotional code input field and submit button

Input field classes: ee-promotion-code-input ee-reg-qstn ee-promo-combo-input

Submit button classes: button button-primary ee-promo-combo-submit

Example CSS for styling the promo code submit button:

input.ee-promo-combo-submit { background-color: green; color: #fff; }

Examples that show how to change default settings using WordPress filter hooks

More custom code snippets


can be found in the Event Espresso code snippet library

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.