Getting Started with Distributions

The Distribution Manager automates communication with your customers. You can publish and distribute promo codes and share promotion updates. Distributions respond to your customers' actions and predefined events. Everything is managed straight from the dashboard with the Distribution Manager. 

You can set multiple distribution channels at the same time.

In this guide, we will review the Distribution Manager features to demonstrate the distribution essentials and workflow.


  1. Glossary
  2. How does it work?
  3. Distribution Setup
  4. Activity


Here are the key definitions you need to grasp to understand how distributions work.


Defines the process of creating a messaging workflow in the Distribution Manager. It comes down to defining message details such as audience, message trigger, purpose, and channel. 

Distribution Manager

The manager enables you to set up a distribution. To open the Manager, go to the Distributions tab in the Engagement section and click on the Plus in the top-right corner.


The publication is an action of assigning a unique code to a particular customer. 


The message means pushing data from Voucherify to the end customer or another application. The message limit in the pricing refers to all distributions that use our API to call your application. 


Action that results in sending the message. You can choose from many triggers to define automatic communication workflows (e.g., customer entered or left segment, order status has changed, code was published, reward was redeemed, and more). 

Automatic Distribution

Trigger-based distribution. Messages are sent in response to a predefined action (trigger), such as a code redemption or a new customer entering the segment. 

Manual Distribution

Manual distribution is a one-time action. Messages are sent once you finish the distribution setup in the Manager and confirm with Save and Send.

Anti-SPAM Policy

By subscribing to the Voucherify Service, you agree to use it in compliance with the Voucherify Anti-spam Policy

Trial Messages Limit

Each trial account has a security limit on messages that can be sent. If you want to unlock the limit, send a request to our Support Team. To unlock the limit, you will have to describe the purpose of using distributions and add your company's name and address in the Brand Details section in your Project Settings. You can learn more details about particular limits in our Fair Use Policy.

Marketing Consent

If you collect marketing consents from your customers, the Distribution Manager lets you define which consents are required to send the message. As a result, only customers who have the given marketing permission checked in Voucherify will receive a message. 


Webhooks allow external services to be notified when certain events happen. You can use a webhook as a distribution channel and push a message to the given webhook every time a distribution is triggered. Please read more to learn about timing and re-enabling paused webhooks.

Custom event

Custom events are actions taken by your customers that you track in your application or website and pass to Voucherify using our API.


The audience defines message receivers. In some distributions, the audience is determined by the distribution trigger. 

Customer segment

Segments group customers using standard attributes (email, postal code, etc.) and custom attributes that have been added as metadata. You can also use custom events and system attributes to create segment criteria. Segments define the campaign/distribution audience in validation rules and distributions. 

Segment syncing

When you create a new segment, you will see a syncing status next to its name. Syncing means checking if your existing customers meet the criteria of the new segment. When syncing is done, you can see a SYNCED status displayed next to the segment name. In a manual distribution, messages are sent 10 minutes after the syncing is completed. 

How does it work?

Creating a distribution in the Distribution Manager is a 4-step process:

  1. Choose a trigger to send messages automatically or manual mode to send a message(s) right away.
  2. Define distribution conditions (name, purpose, audience).
  3. Use marketing consent to group your audience (optional).
  4. Choose a channel and design your template.

Message trigger

When you go to the Distributions tab and click the plus, you will see all available distribution types. 

Besides the manual distribution, you can choose between the following automatic distributions:

  • Customer entered segment - the customer will receive a message once they enter a segment defined in the distribution settings.
  • Customer left segment - the customer will receive a message once they leave a segment defined in the distribution settings.
  • Order update - a message is sent to each customer who updated their order.
  • Order has been paid - a message is sent to each customer who created or updated their order status to 'paid'.
  • Order creation - a message is sent to each customer who created a new order.
  • Order canceled - a message is sent to each customer who canceled their order.
  • Orders

    To use order-related distributions, you need to sync your transactional data with Voucherify and pass order details using our API. Read more about orders in this guide.

  • Successfully published - a message is sent in response to each publication of codes from a particular campaign.
  • Reward redemption - the customer will receive a message once they redeem a reward from a particular campaign. 
  • Gift credits added - the customer will receive a message once they get new credits on a gift card from a particular campaign.
  • Loyalty points added - the customer will receive a message once they get new points on a loyalty card from a particular campaign.
  • Voucher redeemed - the customer will receive a message if they successfully redeem a code from a particular campaign. 
  • Voucher redemption rolled back - a message is sent in response to a redemption rollback of a code from a particular campaign.
  • Custom event - a message is sent in response to a custom event triggered by a customer and sent to Voucherify via API.
  • Customer entered loyalty tier structure - a message is sent when a customer joins a loyalty tier structure.
  • Customer left loyalty tier structure - a message is sent when a customer leaves a loyalty tier structure.
  • Customer loyalty tier upgraded- a message is sent when a customer's loyalty tier is upgraded.
  • Customer loyalty tier prolonged- a message is sent when a customer's loyalty tier validity is extended.
  • Customer loyalty card points expired - a message is sent when points expire on a loyalty card.


You can choose between the following distribution purposes:

  1. Notify customers about promotion  share details of the particular in-cart promotion (promotion tier).
  2. Send and publish unique codes from the campaign  each receiver gets a unique code from the chosen campaign assigned (published) automatically to their profile.
  3. Send a plain message to customers  a plain message with no promo codes included. 


If you send a manual message, your audience can be a customer segment or a single customer. In automatic distribution, the audience is determined by a message trigger:

  • A customer entered or left the segment

In a segment-based distribution, the chosen segment operates as your audience. You can add a new segment using the plus sign or search for existing segments using the magnifying glass. If you choose to create a segment on the spot, use filters to create and save a dynamic segment.

When you send unique codes from a campaign that is limited to a particular segment by validation rules, you will see that segment in the Manager. Mark the checkbox if you want to send messages in response to changes in the segment used in the campaign validation rules.

  • Voucher-based triggers (gift credits added, loyalty points added, voucher redeemed, voucher redemption rollback, reward redemption)

The audience is limited to customers who perform the triggering action using the codes from the chosen campaign. For example, if the trigger is  voucher redeemed, a customer gets a message once they redeem a code from a particular campaign added to the distribution setup.

  • Order status changes

Changes in order status determine the audience. Every customer whose order status changes as defined in the distribution receives the message. 

Validation rules

In this distribution type, you can also create validation rules that must be met to trigger a message. This means that when a customer pays for their order, and the order meets certain rules, like having a sufficient amount, they will get a message. Read more about the rules here.

  • Successful code publication

The message is sent to a customer in response to a code publication. The audience is limited to customers who will get the unique code published to their account (code from a particular campaign).

  • Custom event

The message is sent to each customer who performed a custom event defined in the distribution settings. 

Validation rules

In this distribution type, you can also create customer and event-related validation rules that need to be met to trigger a message. This means that the customer receives a message when he/she performs a predefined event and satisfies distribution validation rules. Read more about the rules here.


Voucherify supports multi-channel delivery. While setting up distribution, you can choose the following integrations and built-in channels:

Note that not all channels entail sending messages to end customers. It is up to you whether the Voucherify messages will be sent directly to the end customers or to the third-party applications of your choice. For example, after choosing Mailchimp or Braze as a channel, messages will not be sent to the end customers. Distribution transfers codes to customer profiles in the respective external application, and then you can forward them to your end users.

Message editor

Voucherify is equipped with a messages editor to customize your emails and text messages. You can choose between a simple template or a configurable flyer that gives you a much wider scope for personalization. 

Here are email customization options:

  • A text editor (font effects, font size, links, text layout). 
  • Variables (e.g., customer name, QR code, loyalty score, referral reward, customer cockpit, reward value, and many more).
  • Images (image size, alt text, link, gif files, alignment).
  • Buttons (CTA size, color, alignment, corners, and link).
  • Dividers (width, color).
  • Social media buttons (LinkedIn, Facebook, Instagram, Twitter, YouTube). 
  • Background (header with your logo, colors, content space, borders, and alignment).
  • Footer (custom information, text, colors).

Enterprise clients get even more customization options, such as custom HTML email templates.

Distribution Setup

Setting up the distribution starts from running the Manager. Go to the Distributions and click the plus. 

Now, decide whether you want to set up manual or automatic distribution.

Manual Distribution

Manual distribution delivers messages once you confirm its settings with Save and send. Please note that each manual distribution is sent with a 10-minute delay, so you can introduce edits or stop the message delivery within this time. 

Step 1: Choose Manual message

Step 2: Define distribution conditions

In Distribution conditions, set the name, define the purpose, and choose your audience. Manual distribution delivers messages to a single customer or all customers from the chosen segment. You can either use the magnifying glass to search for already existing segments or use the plus to add a new segment. If you choose to add a new segment, you can either select customers individually and create a static segment or use filters to create a dynamic segment.

If you create a new customer segment for your audience, a 10-minute countdown starts when the segment is fully synced. Syncing ends once all customers are validated against segment criteria. The syncing status is displayed next to the segment name so you can monitor whether the segment is already synced or if syncing is in progress.

Automatic Distribution

Automatic distributions send messages in response to a predefined action (distribution trigger).  

Step 1: Choose the distribution type (trigger)

After running the Distribution Manager with the plus, click Create next to the chosen distribution type.

Different message triggers represent many automatic distributions. You can choose from among the following actions:

1. Changes in a chosen customer segment:

  • Customer entered segment 
  • Customer left segment

2. Voucher-related activity:

  • Gift credits added 
  • Loyalty points added
  • Loyalty points expired
  • Voucher redeemed
  • Voucher redemption rollback
  • Reward redeemed

3. Cart-related activity (once your order data are synchronized with Voucherify, the distribution can respond to changes in customers' orders):

  • Order created
  • Order updated  
  • Order has been paid
  • Order canceled

4. Loyalty tier related activity:

  • Customer entered loyalty tiers structure
  • Customer left loyalty tiers structure
  • Customer loyalty tier upgraded
  • Customer loyalty tier downgraded
  • Customer loyalty tier prolonged

5. Successful code publication – the message is sent once the code from a campaign is assigned to a customer.

6. Custom event - the message is sent once the customer performs a predefined custom event. 

Step 2: Define distribution conditions

After choosing the trigger, the Manager directs you to the Distribution conditions. You can name the distribution and choose the message purpose, and audience

Step 3: Consents

Using Consents, you can set which marketing permissions are required to send messages or disable consents verification.

Read more about Consents.

Step 4: Channels choice & messages

The next step is to configure channel(s). First, enable channel settings as in the screen below. Note that you can enable many channels within a single distribution.

The detailed message setup depends on the chosen channel. Please go to the dedicated tutorial to see how to configure the message:

After you confirm the distribution, manual messages will be sent with a 10-minute delay, whereas automatic distributions will be triggered every time a customer performs the required action. 

The Distributions list will contain all your distributions, which you can filter by creation date and subject.


You can also view the activities for a particular distribution and get more insights by clicking on the event or log for the activity.

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

Still need help? Contact Us Contact Us