Create Your First Promotion

This guide walks you through creating a simple Gift with Purchase promotion. You'll set a spend threshold, choose a free gift, add a storefront block, and preview the promotion before sharing it with customers.


Step 1: Open Abra and Create a Promotion

  1. Navigate to the Abra app in your Shopify admin

  2. Click Create Promotion

01-empty-overview

Step 2: Set Visibility to Private

Set Visibility to Private while you're building.

Why Private? Private promotions are only accessible via a unique link, so you can test and preview without making the promotion live to everyone. You can switch to Public or Customer Account visibility later.

See Promotion Visibility for details on all visibility types.


03-promotion-visibility

Step 3: Add a Gift with Purchase Discount

  1. Scroll to Discounts and click Add a discount

    04-offer-empty_a6123967-01ab-4499-af97-9c17ab9ad72c
  2. Select Gift with Purchase

05-select-offer-modal
  1. Enter a discount code (e.g., FREEGIFT)

  2. Configure your settings:

  • Customer Buys – Set a spend threshold (e.g., $75)

  • Customer Gets – Choose the free gift product

  1. Click Save

Note: There are additional settings like customer eligibility, usage limits, and markets. For your first promotion, the defaults work fine. See Promotion Configurations for details on all available options.


Step 4: Add a Storefront Block

Storefront blocks display promotion messaging to customers. For your first promotion, add a simple cart banner.

  1. Scroll to Storefront Blocks

  2. Click Add block under Storewide

09-popup-block
  1. Select Popup

    10-edit-block-content

  1. Click Activate in theme editor

  2. The Shopify theme editor will open, drag the block to position it in your cart

  3. Click Save in the theme editor

  4. Return to the promotion and edit the block's messaging if needed

Note: You can add blocks to other pages (product pages, collections, etc.) later. See Storefront Blocks for all block types and placement options.


Step 5: Save and Preview

  1. Click Save in the top right

  2. After saving, click Copy link to get your private promotion link

  3. Click Preview in the upper right hand corner of the promotion page to see how the promotion appears to customers

Screenshot 2025-11-14 at 3.15.57 PM

Open the link in a new browser window and test the promotion:

  • Add items to reach the threshold

  • Check that the gift is added automatically

  • Verify the messaging appears in your cart