Promotion Configuration

A promotion is the container that controls the customer's storefront experience. It defines who sees your offer, when it's active, and how it appears across your store. The discounts inside the promotion handle the logic and math (ie. what customers must do to qualify and what they receive at checkout.) Both layers work together to create the campaign experience.

What a Promotion Controls

Promotions manage the presentation layer of your campaigns:

  • Visibility: Who sees the promotion (Public, Private, or Customer Account)

  • Storefront Blocks: Banners, progress bars, and messaging that appear on your store

  • Active Dates: When the promotion starts and ends

  • Discounts: The logic that determines qualification and rewards (applied at checkout)

How Promotions and Discounts Work Together

Promotions control the storefront experience (who sees it, when, and how it appears). Discounts control the checkout logic (qualification, rewards, and validation).

Example:

  • Promotion: Public visibility, Gift Banner on product pages, active Nov 1-30

  • Discount: Spend $100 → Free Tote, all customers, applies at checkout

Customers see the Gift Banner throughout November showing their progress. When they reach $100 and check out, the discount applies and the tote is added at $0.

Promotion-Level Settings

Promotion Title

The internal name for your promotion. This is used for organization in Abra and does not appear to customers.

Requirements:

  • Maximum 64 characters

  • URL-friendly (no special characters)

Visibility

Controls who sees storefront blocks and messaging.

Options:

  • Public – Everyone sees the promotion automatically

  • Private (Abra Link) – Only customers who click a unique link see the promotion

  • Customer Account – Only logged-in customers with specific tags see the promotion

Screenshot 2025-11-27 at 12.07.15 PM

Discounts

Add one or more discounts to define the qualification logic and rewards.

Screenshot 2025-11-27 at 12.07.37 PM

Each discount includes:

  • Threshold requirements (spend, quantity, eligible items)

  • Rewards (percentage off, free gift, free shipping, etc.)

  • Customer eligibility (all customers or specific segments)

  • Usage limits, markets, channels, and scheduling

You can add up to 5 discounts per promotion.

See Discount Configuration for details on all discount settings.

Storefront Blocks

Control how the promotion appears to customers across your store.

Blocks can be placed on:

  • Product pages

  • Collection pages

  • Cart

  • Customer account pages

  • Storewide (popups, announcement bars)

Each block displays messaging, progress indicators, or gift selection interfaces.

See Storefront Blocks for block types and placement options.

Screenshot 2025-11-27 at 12.08.19 PM

Active Dates

Set when the promotion starts and ends. By default, the promotion uses the start and end dates from your discount. To set custom promotion dates, uncheck Use discount's start and end dates.

Screenshot 2025-11-27 at 12.08.59 PM

Settings:

  • Start date/time (required)

  • End date/time (optional)

If no end date is set, the promotion runs indefinitely.

See Managing Promotion Schedules for scheduling details.

Discount Summaries

After adding discounts, a summary appears showing:

  • Discount code

  • Threshold and reward details

  • Customer eligibility

  • Active dates

  • Last sync status with Shopify

Use this section to quickly review and verify your promotion configuration.

Screenshot 2025-11-27 at 12.11.13 PM