Skip to main content

Add Redcat coupon blocks to your email campaigns

Use Redcat coupon data in EasyEditor extension App blocks.

Written by Laura Russell

The Redcat EasyEditor extension App blocks allow you to easily drag and drop dynamic coupon components directly onto templates in EasyEditor without having to write custom Liquid markup.

The App blocks pick the latest coupon for the program that hasn't been used and is within the program's start and end date.


Before you start

  • You must first install the two Redcat-Dotdigital integrations:

    • The base integration, built by Redcat. Contact them for installation and technical support.

    • The subscription sync back integration, built by Dotdigital. This is a self-serve installation through your Dotdigital Marketing account.
      ​
      This integration, once installed, automatically creates the Redcat coupon code App blocks in EasyEditor.

  • Blocks forming a single coupon must use the same Coupon type and Coupon program.

  • Each block selects the most recently created active coupon matching the chosen Coupon type and exact Coupon program name. If several coupons qualify, the newest is selected. If none qualify, the block displays no content.

  • The coupon’s validity period must include today. Both dates must be available, and the start and end dates are inclusive.


Available extensions

Redcat coupon data blocks are built from four separate extensions:

  • Coupon barcode — redcatBarcode
    Generates a dynamic barcode or QR code image for the latest coupon for the specified coupon program. It encodes the coupon's barcode value and generates a barcode image in the requested barcode format.

  • Coupon code — redcatCoupon

    Displays a coupon code formatted as a heading or paragraph with custom colour and CSS styling.

  • Coupon image — redcatCouponImage

    Displays the promotional voucher image stored in the image_url field for the latest coupon in the specified program.

  • Coupon property — redcatCouponProperty

    Optional - displays any chosen metadata property from the latest coupon record. This is typically used to render terms and conditions (long_description), offer summaries (description), program validity dates (program_start_date, program_finish_date), or the coupon hash.

When placed together inside an email template, these four extensions create a complete coupon block.
​


Use a coupon code block in EasyEditor

  1. In EasyEditor, in the Build tab of the left side menu, expand the Redcat section.

  2. Drag the block you want to use onto the design canvas:

    • Coupon barcode

    • Coupon code

    • Coupon image

    • Coupon property

  3. Select the block to configure it.

  4. In the side panel, edit the parameters for the selected block, then select Apply.

Block styles

Redcat coupon blocks inherit styling from the campaign or page they’re placed in. You can use the block-level styling options or custom CSS to override this default if you want to.


Extension parameters

Coupon barcode

Parameter

Type

Required

Description

Coupon type

Drop-down

Yes

Member: Displays coupons belonging to the recipient.

Guest: Displays coupons linked to the account.

Coupon program

String

Yes

The exact name of the coupon program as configured in Redcat.

For example,

$10 Birthday Reward.
Case-sensitive.

Barcode

Drop-down

Yes

The barcode symbology to generate.

Options: Codabar, Code11, Code128, Code39, Code39E, EAN13, EAN8, qrcode.

Width

Numeric

Yes

Width of the generated barcode or QRimage in pixels.

Min 10, max 1000.

Height

Numeric

Yes

Height of the generated barcode or QRimage in pixels.

Min 10, max 1000.

Error image URL

String

No

Optional web URL of a fallback image to display if the barcode fails to render.

Additional styles

String

No

Additional inline CSS declarations (e.g. font-style: italic; or line-height: 1.3;).

Coupon Code

Parameter

Type

Required

Description

Coupon type

Drop-down

Yes

Member: Displays coupons belonging to the recipient.

Guest: Displays coupons linked to the account.

Coupon Program

String

Yes

The exact name of the coupon program in Redcat.

Text size

Dropdown

Yes

HTML container tag for the code: h1, h2, h3, h4, p.

Text color

Colour picker

No

Hex colour code for the text.

Text alignment

Drop-down

No

inherit, left, center, right, or justify.

The default is inherit, preserving the surrounding alignment.

Additional styles

String

No

Additional inline CSS declarations (e.g. font-weight: bold; text-decoration: underline;).

Overrides selected Text alignment value.

Coupon Image

Coupon images are centred by default.

Parameter

Type

Required

Description

Coupon type

Drop-down

Yes

Member: Displays coupons belonging to the recipient.

Guest: Displays coupons linked to the account.

Coupon Program

String

Yes

The exact name of the coupon program in Redcat.

Width

String

No

Optional width override for the image tag (e.g. 500px or 100%).

To preserve image ratios, set the value for width or height, and leave the other blank, or use auto.

Height

String

No

Optional height override for the image tag (e.g. 500px or 100%).

To preserve image ratios, set the value for width or height, and leave the other blank, or use auto.

Additional styles

String

No

Additional inline CSS declarations.

Coupon Property

Parameter

Type

Required

Description

Coupon type

Drop-down

Yes

Member: Displays coupons belonging to the recipient.

Guest: Displays coupons linked to the account.

Coupon Program

String

Yes

The exact name of the coupon program in Redcat.

Coupon property

Dropdown

Yes

The record field to display: description, long_description, program_start_date, program_finish_date, hash.

Text size

Dropdown

Yes

HTML tag used to enclose the text: h1, h2, h3, h4, p, small.

Text color

Colour picker

No

Hex colour code for the text.

Text alignment

Drop-down

No

inherit, left, center, right, or justify.

The default is inherit, preserving the surrounding alignment.

Additional styles

String

No

Additional inline CSS declarations (e.g. font-style: italic; or line-height: 1.3;).

Overrides selected Text alignment value.


Test the block

To test a Redcat coupon code App block, you must preview as, or test send to, a contact who has data populated in the coupons Insight data collection.

You can create a segment to identify contacts that meet this criteria.

Did this answer your question?