Skip to content

Giveaway Gator - Master Help Document

Compiled from Notion documentation. Intended for the help center chatbot knowledge base.


Table of Contents

  1. What Is Giveaway Gator?
  2. How Entry Math Works
  3. Getting Started / Initial Setup
  4. Bonus Periods (Product Bonus Periods)
  5. Order Bonuses
  6. Order Bonus Progress Bar
  7. Countdown Timer
  8. Countdown Progress Bar
  9. Bonus Discount Codes
  10. Order Multiplier Products
  11. Displaying Entries on Product Cards
  12. How Customers See Their Entries
  13. Exporting Entries
  14. Manual Entries
  15. Thank You Page Entries Display
  16. Test Mode - Preview Before Going Live
  17. Product Bonuses Admin Block (Shopify Admin)
  18. Order Entries Admin Extensions (Shopify Admin)
  19. Manual Entries API
  20. POS Claim External API
  21. FAQs
  22. Post-Purchase Surveys (Unlimited Pro)
  23. Post-Purchase Actions (Unlimited Pro)
  24. Plans & Pricing
  25. Drawing Winners
  26. Order Tag Bonuses (Unlimited Pro)
  27. Pausing Your Plan

1. What Is Giveaway Gator?

Giveaway Gator is a Shopify app that lets you run automated sweepstakes and giveaway promotions. Instead of discounting your products, you reward customers with giveaway entries for every purchase they make — driving sales, increasing average order value, and building excitement around your brand.

The Problem It Solves

Running a giveaway promotion manually is painful. You’d have to track every order, calculate entries, manage bonus periods, and update multipliers — sometimes at 3am when a bonus window opens or closes. Giveaway Gator handles all of this automatically.

How It Works (The Basics)

  1. You create a promotion with a start date, end date, and a Dollar Per Entry rate (e.g., $1 spent = 1 entry).
  2. Customers shop normally. Every time an order is placed, Giveaway Gator automatically calculates how many entries the customer earned.
  3. Entries show up on your store. Product pages and the thank you page display entry information so customers stay engaged.
  4. You draw winners in the app. Draw winners in one click, weighted by entries, with every draw saved for your records. You can still export all entries to CSV for your sweepstakes administrator. See Section 25: Drawing Winners.

What You Can Do With It

Drive sales without discounting:

  • Award giveaway entries instead of offering percentage-off coupons
  • Sell entry multiplier products as virtual add-ons for extra revenue

Create urgency and excitement:

  • Set up bonus periods where entries are multiplied (e.g., “40X entries this weekend!”)
  • Display countdown timers and progress bars on your storefront
  • Offer spending threshold bonuses (“Spend $100+, earn 50 bonus entries”)

Engage customers across channels:

  • Automatically process orders from Shopify, TikTok Shop, Meta, and other channels
  • Let in-store POS customers claim entries from their receipts
  • Give customers a self-service page to check their entry totals

Stay in control:

  • Add manual entries for customer service situations or special promotions
  • Set product-specific bonuses to spotlight featured items
  • Draw winners in the app, weighted by entries, with every draw saved
  • View detailed audit logs showing exactly how every entry was calculated
  • Configure bonus discount codes that award extra entries

Re-engage and understand customers (Unlimited Pro):

  • Reward post-purchase surveys to collect feedback and capture data like birthdays
  • Reward post-purchase actions such as social follows and referrals
  • Award order tag bonuses when an order has a Shopify tag (see Section 26)
  • Restrict a promotion to specific products
  • Understand your audience with customer analytics and segments

2. How Entry Math Works

Understanding how entries are calculated helps you design better promotions and answer customer questions. Giveaway Gator uses a layered system — each step builds on the previous one.

Step 1: Base Entries

Every promotion has a Dollar Per Entry setting. This is the base conversion rate. For example, if you set $1 = 1 entry, a customer who spends $50 earns 50 base entries.

Each item in the order is calculated individually: item price x quantity, divided by the Dollar Per Entry rate, rounded down.

Count entries after discounts

Count entries after discounts is turned on per shop. Contact support to turn this on.

When it is on, entries are counted from the price a customer actually pays after discounts, instead of the pre-discount price. Order-level discount codes are included. The discount is spread over the line items, so entries drop in proportion.

Step 2: Product Bonuses (Multipliers & Flat Bonuses)

You can set bonus multipliers or flat bonus entries on specific products. The system uses a priority hierarchy — only the highest-priority bonus applies per product:

  1. Product Bonus Periods (highest priority) — Time-limited bonuses on specific products within a promotion. If active, these override everything below.
  2. Super Bonuses (medium priority) — Shop-wide product bonuses set from the Shopify product admin page. Apply across all promotions.
  3. Promotion Default Multiplier (lowest priority) — A baseline multiplier for all products in the promotion, used when no specific product bonus applies.

Important: These don’t stack. If a product has a Product Bonus Period active, the Super Bonus and Default Multiplier are ignored for that product.

Step 3: Bonus Period Multiplier

If a Bonus Period is active at the time of the order, entries for products without a specific product bonus are multiplied. For example, during a 3X bonus period, a product with 50 base entries earns 150 entries.

Products that already have a product-specific bonus (from Step 2) are NOT affected by the bonus period multiplier — they use their own multiplier instead.

Step 4: Order Bonuses (Spending Thresholds)

Order bonuses reward customers for spending more. You set dollar thresholds with bonus entry amounts. For example: “Spend $100+, earn 50 bonus entries.” Giveaway Gator compares the threshold to the sum of counted product line amounts. That sum leaves out 0x products, shipping, and tax, and uses list price unless after-discount counting is on. These are flat bonus entries added on top.

Order bonuses also have priority:

  • Time-Period Order Bonuses (higher priority) — Active during specific time windows.
  • Promotion-Wide Order Bonuses (lower priority) — Apply throughout the entire promotion.

Step 5: Discount Code Bonuses

If a customer uses a discount code that has bonus entries configured, those entries are added as a flat bonus.

Step 6: Order Tag Bonuses (Unlimited Pro)

If the order has a Shopify tag that matches an order tag bonus, that bonus is applied after discount code bonuses. Matching is case-insensitive and uses the tags on the order.

  1. Flat bonus entries from every matching tag are added together.
  2. If any matching tag has a multiplier greater than 1, the highest one is applied once to that subtotal.

A purchased Upgrade multiplier skips this step. A purchased Super Multiplier still runs after it. See Section 26: Order Tag Bonuses.

Step 7: Order Multiplier Products (Final Multiplier)

These are virtual Shopify products that customers can purchase to multiply their entries. There are two types:

  • Upgrade Multiplier — Replaces all other multipliers and skips order tag bonuses. If a customer buys a 100X upgrade, their entire order uses 100X instead of whatever the current multiplier is.
  • Super Multiplier — Multiplies the final entry count after all other calculations. For example, if an order earned 250 entries and the customer bought a 10X Super Multiplier, they get 2,500 entries.

Final Result

After all layers are applied, the total is rounded down to a whole number. That’s the customer’s final entry count.

Example Calculation

A customer places a $120 order during a 3X bonus period, with a $100+ order bonus of 50 entries, using discount code “VIP10” worth 25 bonus entries:

  1. Base entries: $120 / $1 per entry = 120 entries
  2. Product bonuses: No product-specific bonuses → skip
  3. Bonus period: 3X active → 120 x 3 = 360 entries
  4. Order bonus: $120 meets the $100 threshold → +50 = 410 entries
  5. Discount code: VIP10 → +25 = 435 entries
  6. Order tag bonus: No matching tag
  7. Order multiplier products: None
  8. Final total: 435 entries

A $10 order at $1 per entry during a 5× bonus period earns 50 entries. With a matching 2× order tag bonus, that subtotal is multiplied once: 50 × 2 = 100 entries. The same order with no matching tag stays at 50.


3. Getting Started / Initial Setup

Welcome email

When you install Giveaway Gator, you’ll get one email from Giveaway Gator with the subject Finish setting up Giveaway Gator. The main button opens the app so you can finish setup and create your first promo. It only sends once — existing shops aren’t emailed, and reinstalling won’t send it again.

Step 1: Create a Promotion

  1. Open the Giveaway Gator app from your Shopify admin dashboard.
  2. Click Create promotion.
  3. In the create modal, fill in the promotion details:
    • Name: Give your promotion a descriptive name.
    • Dollar Per Entry: Set how many dollars a customer needs to spend to earn 1 entry (e.g., $1 = 1 entry). Minimum is $1.
    • Start Date & End Date: Set when the promotion runs. The modal saves the start and end dates you enter.
    • Timezone: Select the timezone for your promotion. If you’ve set a default timezone in App Preferences, it will be pre-selected.

Important: To include the full last day of your promotion, set the end time to 12:00 AM on the day after the final day. For example, for a promotion ending October 31st, set the end date to November 1st at 12:00 AM.

  1. Click Create. The promotion is saved with those start and end dates.

Promotion page actions

Open a promotion. The title bar has actions for that promotion:

  • Product list
  • Order list
  • Entries

Step 2: Add Giveaway Gator to Your Storefront

Giveaway Gator tracks entries automatically in the background — even without any theme setup, every order is processed and entries are calculated. But to show customers their entries, display countdown timers, and build excitement, you’ll want to add Giveaway Gator’s storefront components.

These are the components most merchants install right away:

1. Enable the Giveaway Gator App Embed

This is the engine that powers all the storefront blocks below. It runs site-wide and handles entry calculations, countdown timers, and global styling.

  1. Go to Shopify Admin > Online Store > Themes.
  2. Click Customize on your active theme.
  3. In the left sidebar, click App embeds (the puzzle piece icon).
  4. Toggle on Giveaway Gator.
  5. Click Save.

You can customize global styling here — colors, font size, border radius, and multiplier badge appearance. These settings apply to all Giveaway Gator blocks across your store.

2. Add the Giveaway Entry Tag to Product Pages

This shows customers how many entries a product is worth (e.g., “50 entries” or “50 entries 3X”). It automatically updates when a customer selects a different variant.

  1. In the theme editor, go to your product page template.
  2. Click Add block in the product information section.
  3. Under Apps, select Giveaway Entry Tag.
  4. Position it where you’d like (e.g., below the price), then Save.

See Displaying Entries on Product Cards for more details.

3. Add the Thank You Page Extension

This shows customers how many entries they just earned after completing a purchase. It activates automatically once the app is installed — you can customize it from Shopify Admin > Settings > Checkout > Thank you page.

See Thank You Page Entries Display for more details.

4. Add the Entry Checker

This gives customers a self-service page to look up their total entries by email. Create a page (e.g., “/pages/check-entries”), then:

  1. In the theme editor, navigate to that page.
  2. Click Add block and select Entry Checker under Apps.
  3. Customize the title, button text, and styling, then Save.

See How Customers See Their Entries for more details.

Advanced Blocks

These blocks add extra engagement features. They all require the Giveaway Gator app embed to be enabled.

To add any of these: in the theme editor, click Add block in the section where you want it, select the block under Apps, configure it, and Save.

Timer Banners — A countdown timer showing time remaining in your promotion or bonus period. Supports 4 display styles: Inline, Banner, Floating, and Boxes. You can customize the timer template using placeholders like ${days}, ${hours}, ${minutes}, ${seconds}. See Countdown Timer.

Timer Boxes — A dedicated boxes-style countdown timer with additional layout options like label placement (inside or outside boxes), separator visibility, and independent desktop/mobile sizing. Use this instead of Timer Banners if you want more control over the boxes layout.

GG Progress Bar — An animated progress bar that fills up as the promotion or bonus period countdown progresses. Multiple animation styles available: Pulse, Gradient Flow, Left-Right Pulse, and Glow Pulse. Can also add slanted bar overlays. See Countdown Progress Bar.

POS Receipt Claim — A form for in-store POS customers to claim giveaway entries by entering their receipt number, name, and email. See POS Claim External API.

Step 3: Set Up Bonus Periods (Optional)

See Bonus Periods for how to create time-limited entry multipliers.


4. Bonus Periods (Product Bonus Periods)

Bonus periods let you multiply entry amounts during specific timeframes, encouraging more engagement.

How to Set Up a Bonus Period

  1. Open Giveaway Gator and go to Promotions.
  2. Click Manage on your existing promotion.
  3. Navigate to the Bonus Periods section.
  4. Click Add Bonus Period.
  5. Fill in the form:
    • Name: A descriptive name (e.g., “Mother’s Day 40X Bonus”).
    • Multiplier: The entry multiplier (e.g., 40 means customers get 40x entries).
    • Start Date & End Date: The bonus window.
    • Description: An optional description.
  6. Click Save.

Important: To include the full last day of your bonus period, set the end date to 12:00 AM on the day after the final day. For example, for a bonus ending July 12th, set the end date to July 13th at 12:00 AM.

Verify the Multiplier

After saving, refresh your product page. The entries tag should reflect the new multiplier (e.g., “40X” instead of “1X”).

Multiple Promotions

If two promotions run at the same time, give them the same multiplier so customers see one clear number.

Promotions limited to specific products do not need to line up. They never set the site-wide multiplier, because they are not site-wide.

Entry tags and the countdown timer show one promotion.

  1. Promotions limited to specific products are left out.
  2. Among site-wide promotions that have a bonus running right now, the one that ends first wins. If two end at the same time, the higher multiplier wins.
  3. If no site-wide promotion has a bonus running, the site-wide promotion that ends first is shown at 1X. A bonus that starts later counts as no bonus until it starts.

This runs automatically, nothing to set.

See Running Multiple Promotions.


5. Order Bonuses

Order bonuses multiply the total entries for an entire order based on spending thresholds. This encourages customers to spend more.

How to Set Up Order Bonuses

  1. Log in to Giveaway Gator and go to Promotions.
  2. Click Manage on your promotion.
  3. Navigate to the Order Bonuses section.
  4. Set bonus period dates — ensure they align with your promotion duration.

Note: To cover the entire last day, set the end date to the day after the final day. For example, for a promotion ending October 1st, set the bonus period to end on October 2nd.

  1. Click Create to save the bonus period settings.
  2. Verify: Refresh your product page to confirm the multiplier (e.g., “50x”) is displaying correctly.

6. Order Bonus Progress Bar

The order bonus progress bar shows customers how close they are to reaching the next order bonus threshold.

Note: This documentation is under construction.

Theme-Based Carts

  1. Ensure “Order Bonuses” is enabled in the “Giveaway Gator Body Embed” theme embed.
  2. Add this snippet to your theme cart to render the progress bar:
<div id="gg-order-bonuses-progress"></div>

Using with Slide Cart by Amp

<script>
    window.SLIDECART_LOADED = function(cart) {
      window.ggatorInitializeProgressBar();
    }

    window.SLIDECART_UPDATED = function(cart) {
      window.ggatorUpdateProgressBar(cart.items_subtotal_price);
    }
</script>

Customizing the Progress Bar

The progress bar can be styled with CSS. Key classes include:

  • .gg-order-bonuses-container — Main container
  • .gg-progress-bar-background — Progress bar track
  • .gg-progress-bar-fill — Progress bar fill
  • .gg-threshold-badge — Individual threshold badges
  • .gg-threshold-badge.active — Reached threshold badges
  • .gg-next-threshold-message — “Spend $X more” message

7. Countdown Timer

Countdown timers create urgency by showing customers how much time remains in your promotion or bonus period.

Prerequisites

  1. Enable the Giveaway Gator Body Tag in your theme’s App Embeds.

Basic Implementation

Add this HTML element anywhere in your theme:

<div data-gg-countdown-timer></div>

Customization Options

Data Attributes:

  • data-gg-countdown-timer (required) — Initializes the timer.
  • data-template (optional) — Custom display format.
    • Default: ${days}d ${hours}h ${minutes}m ${seconds}s
    • Variables: ${days}, ${hours}, ${minutes}, ${seconds}, ${multiplier}, ${multiplierX}
  • data-style (optional) — Display style (default: inline).
  • data-gg-end (optional) — Set to promo to count down to the giveaway end. See End time.

Example Templates

<!-- Basic Timer -->
<div data-gg-countdown-timer></div>

<!-- Custom Format -->
<div data-gg-countdown-timer
  data-template="${days} Days, ${hours}:${minutes}:${seconds}"></div>

<!-- With Multiplier -->
<div data-gg-countdown-timer
  data-template="${multiplierX} Bonus Entries - ${days}d ${hours}h left!"></div>

CSS Styling

.gg-countdown-timer {
  --gg-timer-bg: #f3f4f6;
  --gg-timer-text: #111827;
  --gg-timer-font-size: 16px;
  --gg-timer-border-radius: 4px;
}

Behavior Notes

  • Starts when the page loads
  • Keeps working in the theme editor when you add or remove sections
  • Auto-updates every second
  • Revalidates every 5 minutes for accuracy
  • Auto-hides when countdown reaches zero
  • Shows bonus multipliers when active
  • Counts down to the active bonus period when one is running, and to the giveaway end otherwise. See End time
  • If multiple promotions are running, shows the site-wide promotion the storefront picks. See Running Multiple Promotions

End time

By default, the timer counts down to the end of the active bonus period when one is running. If no bonus period is active, it counts down to the giveaway end.

Add data-gg-end="promo" to skip the bonus period and always count down to the giveaway end. This works on a text timer, timer boxes, and the countdown progress bar.

Turn on the Giveaway Gator app embed. If the giveaway has no end date, or that date has already passed, the timer stays hidden.

Text timer

<span data-gg-countdown-timer data-style="inline" data-gg-end="promo" data-template="${days}d ${hours}h ${minutes}m ${seconds}s"></span>

Timer boxes

Add four elements with the class gg-timer-value, in this order: days, hours, minutes, seconds.

<div data-gg-timer-boxes data-gg-end="promo">
  <span class="gg-timer-value"></span>
  <span class="gg-timer-value"></span>
  <span class="gg-timer-value"></span>
  <span class="gg-timer-value"></span>
</div>

8. Countdown Progress Bar

The countdown progress bar is a visual component that transforms countdown timers into animated progress bars.

Key Features

  • Minimum 50% fill — never looks empty
  • Smart progress: 50% baseline at 4+ days, linear to 100% in final 4 days
  • 5 animation types: None, Pulse, Gradient Flow, Left to Right Pulse, Glow Pulse
  • Slanted bars overlay with customizable width and speed
  • Shadow & glow effects with color and intensity control

Implementation Methods

Method 1: Theme Editor Block Add the “GG Progress Bar” block in the Shopify theme editor. No code required.

Method 2: Custom Liquid (Class-Based)

<div class="gg-countdown-progress"></div>

Method 3: Page Builder (Attribute-Based)

<div gg-countdown-progress></div>

You can also use data-gg-countdown-progress. See Progress bar end time.

Progress bar end time

By default, the bar moves toward the end of the active bonus period when one is running. If no bonus period is active, it moves toward the giveaway end.

Add data-gg-end="promo" to skip the bonus period and always use the giveaway end.

<div data-gg-countdown-progress data-gg-end="promo"></div>

Turn on the Giveaway Gator app embed. The bar starts when the page loads, and it updates in the theme editor when you add or remove sections.

If the giveaway has no end date, or that date has already passed, the bar stays hidden.

CSS Variables

/* Core */
--gg-progress-height: 20px;
--gg-progress-border-radius: 10px;
--gg-progress-start-color: #ef4444;
--gg-progress-end-color: #dc2626;
--gg-progress-bg: #e5e7eb;

/* Animation */
--gg-animation-speed: 2s;
--gg-slanted-speed: 1.5s;
--gg-slanted-width: 8px;

/* Shadow & Glow */
--gg-progress-shadow: 0 0 20px #ff0000;
--gg-glow-color: #ff0000;

Page Builder Integration

Works with PageFly, GemPages, Shogun, and LayoutHub — use their HTML/Custom Code blocks.


9. Bonus Discount Codes

Bonus discount codes award extra entries when customers use specific codes at checkout.

How to Set Up

  1. Log in to Giveaway Gator and go to Discount Codes > Add Discount Codes.
  2. Fill in the details:
    • Discount Code: The code customers will use (e.g., “FREESHIPPING25”).
    • Usage Limit: Leave blank for unlimited or set a max.
    • Bonus Entries: The number of bonus entries the code awards.
  3. Click Add to save and activate.

Managing Codes

View and manage codes in the Discounts tab in your Shopify admin.


10. Order Multiplier Products

Order Multiplier Products are virtual Shopify products that your customers can add to their cart to multiply their giveaway entries. Instead of giving away bonus entries for free, you can sell multipliers — turning your giveaway into a revenue driver.

Two Types of Multipliers

Upgrade Multiplier

  • Replaces the current multiplier for the entire order
  • All other bonuses are skipped (product bonuses, bonus periods, order bonuses, discount codes, order tag bonuses)
  • Example: Customer orders during a 25X bonus period and buys a “100X Upgrade” — entire order earns at 100X instead of 25X

Super Multiplier

  • Multiplies the final entry count after all other calculations
  • Stacks on top of everything
  • Example: Customer earns 250 entries normally, buys a “10X Super Multiplier” — final total becomes 2,500 entries

Setting Up

  1. Open Giveaway Gator in your Shopify admin.
  2. Go to Order Multipliers from the navigation.
  3. Click Create Multiplier Product.
  4. Fill in: Product Name, Multiplier Value (minimum 2), Multiplier Type (Upgrade or Super).
  5. Click Create.

You can also configure an existing Shopify product as a multiplier using the Configure Existing Product option.

Managing Multiplier Products

  • Edit the multiplier value
  • Publish/unpublish — Toggle availability (ACTIVE/DRAFT in Shopify)
  • Delete — Removes from both Giveaway Gator and Shopify

How It Affects Calculations

Multiplier products are excluded from the base entry calculation — their price doesn’t count toward dollar-per-entry math.

  • Upgrade Multiplier: Base Entries × Upgrade Multiplier (skips all other bonuses, including order tag bonuses)
  • Super Multiplier: Normal Total × Super Multiplier (applied at the very end, after order tag bonuses)

Tips

  • Price multipliers strategically — a $5 product for 10X entries feels like a great deal
  • Use Upgrade Multipliers for simplicity, Super Multipliers for stacking power
  • Only one multiplier per type applies per order (highest value used)
  • Multiplier products appear in audit logs

11. Displaying Entries on Product Cards

The gg-entry-tag displays entry calculations on product cards throughout your store.

What It Shows

  • Base entries based on product price and dollar-per-entry setting
  • Bonus entries from product bonuses, multipliers, or bonus periods
  • Visual indicators like “2X” badges for multipliers

Prerequisites

  1. Giveaway Gator app installed and configured
  2. Active promotion with products selected
  3. App embed enabled in your theme

Add via the Theme Editor (No Code)

On product pages, and on collection product cards in Horizon and other newer Online Store 2.0 themes, add the Giveaway Entry Tag app block directly in the theme editor — no code:

  1. Go to Online Store > Themes > Customize.
  2. Open the product page template, or select your collection’s product card / product grid section.
  3. Click Add block, then under Apps choose Giveaway Entry Tag.
  4. Position it, style it, and Save. On collection cards the block automatically reads each card’s product.

Each block offers a Display style (Minimal or Detailed), an optional custom-colors override, font size, and border radius.

Quick Start (Older Themes — Code Snippet)

If your theme doesn’t support app blocks on product cards, add this HTML snippet to your product card template:

<div
  class="gg-entry-tag"
  data-gg-entry-tag
  data-product-id="{{ card_product.id }}"
  data-price="{{ card_product.price | money_without_currency | strip }}"
>
  <span class="gg-entry-total"></span>
  <span class="gg-entry-bonus"></span>
</div>

Important: Make sure the product variable (e.g., card_product) matches what your theme uses in the same snippet or section.

Common Template Locations

  • snippets/product-card.liquid
  • snippets/card-product.liquid
  • sections/collection-template.liquid
  • sections/main-collection.liquid

Variant Support

Include variant data for automatic price updates when customers select different variants:

<div
  class="gg-entry-tag"
  data-gg-entry-tag
  data-product-id="{{ product.id }}"
  data-price="{{ product.selected_or_first_available_variant.price | money_without_currency | strip }}"
  data-variant-id="{{ product.selected_or_first_available_variant.id }}"
  data-variants="{{ product.variants | json | base64_encode }}"
>
  <span class="gg-entry-total"></span>
  <span class="gg-entry-bonus"></span>
</div>

Variant updates work automatically via URL parameter watching and DOM selector watching.

CSS Customization

.gg-entry-tag {
  --gg-tag-bg: #f4f4f4;
  --gg-tag-text: #333333;
  --gg-tag-accent: #000000;
  --gg-tag-bonus: #17a2b8;
  --gg-tag-font-size: 16px;
  --gg-tag-border-radius: 4px;
}

.gg-entry-multiplier {
  --gg-tag-multiplier-bg: #059669;
  --gg-tag-multiplier-text: #ffffff;
  --gg-tag-multiplier-radius: 4px;
}

Tip: It’s best to use the style settings in the App Embed settings to keep things consistent across your store.

Testing Entry Tags

Open your browser console and run:

window.GiveawayGator.test();    // Enable test mode
window.GiveawayGator.test(false); // Disable test mode

Troubleshooting

Entry tag not showing:

  • Verify the app embed is enabled in your theme
  • Check that window.GiveawayGator exists in the browser console
  • Ensure all required attributes are present (class, data-gg-entry-tag, data-product-id, data-price)
  • Verify inner spans exist (gg-entry-total, gg-entry-bonus)

Shows “0 entries”:

  • Check the app embed is enabled
  • Verify the product liquid variable matches the rest of the section
  • Check that data-price has a valid number
  • Verify the dollar-per-entry setting in your promotion

Variants not updating:

  • Ensure data-variants attribute is present
  • Check that variant data is properly base64-encoded

Thousand Separators

Entry tags can show larger counts with separators that match your storefront language, such as 1,500 in English or 1.500 in German. The number used to calculate entries does not change.

Use thousand separators stays off until you turn it on.

  1. Go to Online Store > Themes > Customize.
  2. Open App embeds.
  3. Select Giveaway Gator.
  4. Enable Use thousand separators, then Save.

To override one tag or a section, add data-gg-thousands="true" or data-gg-thousands="false" on the entry tag or on a parent element. The tag wins over the section, and the section wins over the app embed setting.

<div data-gg-thousands="true">
  <div
    class="gg-entry-tag"
    data-gg-entry-tag
    data-product-id="{{ card_product.id }}"
    data-price="{{ card_product.price | money_without_currency | strip }}"
    data-gg-thousands="false"
  >
    <span class="gg-entry-total"></span>
    <span class="gg-entry-bonus"></span>
  </div>
</div>

In this example the section turns separators on, and the tag turns them off. The tag wins, so this tag shows the count without separators.


12. How Customers See Their Entries

Customers can check their total entries via a dedicated “Check Your Entries” page.

Setup

  1. Create a page template in your Shopify theme for the entries page.
  2. Add the “Check Entries Form” block to the template.
  3. Customize the styling to match your brand.

13. Exporting Entries

To pick winners, use Draw winners on the promotion’s Winners page. See Section 25: Drawing Winners. This export is the full record of every entry for your sweepstakes administrator. There isn’t a separate winners file.

How to Export

  1. Open Giveaway Gator from your Shopify dashboard.
  2. Find the promotion and click Entries > View Entries.
  3. Click the Export Entries button (top right corner).
  4. A CSV or Excel file will automatically download.

Excel / CSV Contents

Column Description
Email Customer’s email address
Name Customer’s name
City Customer’s city from the order billing address when present; blank when there isn’t one (digital or API entries)
State Customer’s state/province from the order billing address when present; blank when there isn’t one (digital or API entries)
Order Number Shopify order number (blank for manual entries)
Amount Order dollar amount
Total Entries Number of entries awarded
Valid Whether the entry is valid (Yes/No)
Created At Date and time the entry was created

City and State: Excel/CSV exports include City and State, taken from the order billing address when present. They’re blank when there isn’t one (digital or API entries).


14. Manual Entries

How to Add Manual Entries (In-App)

  1. Open Giveaway Gator and select the promotion.
  2. Click Manage to open the promotion details.
  3. Navigate to the Entries section.
  4. Click the Manual Entry button.
  5. Fill in:
    • Email Address: Customer’s email.
    • Reason: Why you’re adding the entry (e.g., “Bonus for special promotion”).
    • Number of Entries: How many entries to add.
  6. Click Add Entry.

The manual entry will appear in the Entries list with “MANUAL” as the order number.

Revalidating Invalid Entries

You can restore invalid entries from a promotion’s Entries list — one at a time, or several at once.

  1. In Giveaway Gator, go to Promotions and open the promotion.
  2. Open Entries.
  3. Revalidate a single invalid entry, or select several and revalidate them together.
  4. When asked, enter a note explaining why. This note is required and is saved on the entry history.

After you revalidate, a later order sync will not undo the restore just because payment had previously failed or been voided. If the order is later refunded or cancelled, the entry can become invalid again.


15. Thank You Page Entries Display

Display total entries earned on the order confirmation (thank you) page. Setup is done via the Shopify checkout editor — add the Giveaway Gator thank you page blocks.

(Video walkthrough available in the app documentation.)

Customers see how many entries they earned from the order, broken down by promotion. You can also show bonus actions, such as social follows, on this page. Open the editor from Shopify Admin > Settings > Checkout > Thank you page.

Giveaway Entries Confirmation

Giveaway Entries Confirmation shows the entry total for the order. It has a Show bonus actions setting.

  • Leave Show bonus actions on if you do not add the Giveaway Bonus Actions block. Existing thank-you pages keep showing actions.
  • Turn Show bonus actions off after you add Giveaway Bonus Actions, so customers do not see the actions twice.

Giveaway Bonus Actions

You can add a Giveaway Bonus Actions block on the thank-you page, separate from the entries confirmation. Use it for social follows and other bonus actions, and place it where you want.

  1. Go to Shopify Admin > Settings > Checkout > Thank you page.
  2. Add the Giveaway Bonus Actions app block.
  3. Place it where you want it on the page, then save.

The block shows your bonus actions. It does not replace the entry total. Keep Giveaway Entries Confirmation on the page so customers still see how many entries they earned. After you add the block, turn Show bonus actions off.

Bonus actions are showing twice: Open Giveaway Entries Confirmation and turn Show bonus actions off.


16. Test Mode - Preview Before Going Live

There are two ways to preview your storefront before a real giveaway is running.

Preview Mode (Theme Editor — No Code)

In the theme editor, open App embeds, expand Giveaway Gator, and check Preview mode. Your entry tags and countdown timer fill with sample data so you can style them even when no giveaway is active. It affects only the theme editor preview — never your live storefront. Uncheck it when you’re done.

Storefront Test Mode (Advanced)

For a deeper test on your live storefront, the window.GiveawayGator.test() browser-console tool simulates active promotions without configuring real ones.

Basic Usage

// Enter test mode with defaults
window.GiveawayGator.test()

// Enter test mode with custom config
window.GiveawayGator.test({
  dollarPerEntry: 10,
  entryCalculation: {
    bonusPeriod: {
      multiplier: 5,
      endTime: "2025-07-07T12:00:00"
    }
  }
})

// Exit test mode
window.GiveawayGator.test(false)

Default Test Configuration

  • Active promotion ending in 7 days
  • Bonus period ending in 2 days with 3x multiplier
  • $5 per entry conversion rate
  • Sample product bonuses

Features

  • Orange “TEST MODE” badge in top-right corner
  • Persists across page navigation (via sessionStorage)
  • Auto-expires after 2 hours
  • All components (entry tags, countdown timers) update immediately
  • Original configuration is preserved and restored on exit

Configuration Options

Property Type Description
dollarPerEntry Number How much money = 1 entry
entryCalculation.bonusPeriod.multiplier Number Entry multiplier during bonus period
entryCalculation.bonusPeriod.endTime String (ISO) When bonus period ends
entryCalculation.defaultMultiplier Number Default entry multiplier
entryCalculation.productBonuses Object Product-specific bonuses

17. Product Bonuses Admin Block (Shopify Admin)

Configure Super Bonuses directly from your Shopify product pages — no need to switch apps.

Capabilities

Entry Multiplier:

  • Set a multiplier for base giveaway entries (e.g., 3 = 3x entries for this product)
  • Perfect for featured products, new launches, high-margin items

Flat Bonus Entries:

  • Add a fixed bonus amount when product is purchased (e.g., +50 extra entries)
  • Perfect for VIP products, bundle incentives, clearance items

How to Use

  1. Navigate to any product page in Shopify Admin.
  2. Scroll to the “Giveaway Gator Super Bonuses” block.
  3. Click “Add Super Bonus”.
  4. Enter values:
    • Entry Multiplier (e.g., 2 for double entries)
    • Bonus Entries (e.g., 100 for 100 extra entries)
  5. Save — bonuses are live immediately.

Configuration Tips

  • Set to 0 to disable without deleting
  • Clear fields to completely remove bonuses
  • Integer values only
  • Changes apply to ALL active promotions
  • Effect is immediate for new orders

18. Order Entries Admin Extensions (Shopify Admin)

View giveaway entries and audit logs directly in the Shopify order detail page.

Order Entries Block

  • Appears on Shopify order detail pages
  • Shows total entry count across all active promotions
  • Displays individual promotion breakdown

Order Entries Audit Action

  • Triggered via “View Audit Logs” button
  • Shows complete entry calculation audit trail:
    • Promotion Details (name, dates, conversion rate)
    • Entry Calculations (line-by-line)
    • Multipliers applied
    • Bonus Periods checked
    • Product Bonuses applied
    • Order Bonuses applied
    • Final Result with total entries

Use Cases

  • Customer inquiries: Instantly see how many entries an order received
  • Troubleshooting: Detailed audit logs show exact calculation steps
  • Promotion analysis: Verify multipliers and bonuses are working correctly

These extensions deploy automatically with the Giveaway Gator app — no additional setup required.


19. Manual Entries API

Create one giveaway entry from your own system. Loyalty programs, referrals, and other awards that are not a Shopify order use this call.

If you do not want to write code, use the Add Entries action in Shopify Flow.

Endpoint

POST https://giveawaygator.app/api/entries/create
Content-Type: application/json

Send one entry per request. There is no bulk endpoint.

Authentication

Create a key in Giveaway Gator > Settings > API Key. Send it on every request:

Authorization: Bearer gg_your_api_key_here

Rate Limits

Each key can make 60 requests per minute. Over the limit, the API returns 429.

Request Fields

Field Type Required Description
promoId string Yes Promotion to add the entry to
totalEntries number Yes Greater than 0. The stored count is the whole-number part.
email string One of email or phone Customer email
phone string One of email or phone At least 10 digits. A 10-digit number is stored with a leading 1.
name string No Customer name
notes string No Reason on the entry history. Defaults to “Manual entry via API”.

Example

curl -X POST \
  https://giveawaygator.app/api/entries/create \
  -H 'Authorization: Bearer gg_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{"promoId":"promotion-uuid","email":"customer@example.com","totalEntries":10,"name":"Jane Smith","notes":"Referral bonus"}'

Response

Success (201):

{
  "success": true,
  "entry": {
    "id": "entry-uuid",
    "email": "customer@example.com",
    "phone": null,
    "name": "Jane Smith",
    "totalEntries": 10,
    "createdAt": "2026-01-15T12:00:00.000Z",
    "promoName": "Spring Giveaway"
  }
}

Error example (400):

{ "error": "promoId is required" }

Notes

  • The promotion must be active and must belong to the shop that owns the API key
  • A promotion limited to specific products does not accept this call
  • There is no idempotency key. A repeat request creates another entry.
  • The entry history shows source api

20. POS Claim External API

Allow customers to claim giveaway entries from POS (Point of Sale) receipts.

Endpoint

POST /api/theme/pos-claim?shop={shop_domain}
Content-Type: application/json

Authentication

  • Theme embed: Automatic via Shopify app proxy signature
  • Custom integration: Authorization: Bearer {GIVEAWAY_GATOR_API_KEY}

Rate Limits

  • Theme embed: 10 requests/minute per IP
  • API key: 60 requests/minute per key

Request Body

{
  "receiptNumber": "POS12345",
  "email": "customer@example.com",
  "firstName": "Ada",
  "lastName": "Lovelace"
}

All fields are required.

Response

{
  "status": "success",
  "orderId": "gid://shopify/Order/123456789",
  "orderName": "#1001",
  "entriesAwarded": 15,
  "claimedAt": "2025-01-05T22:41:03.123Z",
  "promotions": [
    {
      "promoId": "promo-uuid",
      "promoName": "Holiday Giveaway",
      "entriesAwarded": 15,
      "alreadyClaimed": false,
      "claimedAt": "2025-01-05T22:41:03.123Z"
    }
  ]
}

Status Values:

  • success — Entries awarded
  • already_claimed — All promotions already claimed
  • no_active_promotions — Order found but no active promos
  • not_found — No matching order
  • error — Unexpected failure

Theme Embed Example

<form method="post"
  action="/apps/giveaway-gator/api/theme/pos-claim?shop={{ shop.permanent_domain }}"
  id="gg-pos-claim-form">
  <label>Receipt Number <input type="text" name="receiptNumber" required></label>
  <label>Email <input type="email" name="email" required></label>
  <label>First Name <input type="text" name="firstName" required></label>
  <label>Last Name <input type="text" name="lastName" required></label>
  <button type="submit">Claim Entries</button>
</form>

Best Practices

  • Always include the shop query parameter
  • Store API keys securely and rotate if compromised
  • Ensure orders are ingested into Giveaway Gator before claiming
  • Consider CAPTCHA for front-end forms to reduce abuse

21. FAQs

How are entries calculated?

Entries are calculated automatically when an order is placed. The system uses a layered approach — see the detailed breakdown in Section 2: How Entry Math Works. In short: base entries come from the Dollar Per Entry rate (e.g., $1 = 1 entry), then product bonuses, bonus period multipliers, order bonuses, discount code bonuses, order tag bonuses, and order multiplier products are applied in sequence. Each layer builds on the previous one.

Do entries sync automatically?

Yes. Giveaway Gator automatically processes new orders and calculates entries in real-time. No manual sync is needed.

What about post-purchase upsells?

Post-purchase upsell orders are processed automatically. The upsell amount is included in the entry calculation just like a regular order.

How can customers check their entries?

Customers can visit a dedicated “Check Your Entries” page on your store. You set this up by creating a page template and adding the “Check Entries Form” block.

What about TikTok Shop and Meta orders?

Orders from TikTok Shop and Meta that sync to Shopify are processed automatically. As long as the order appears in your Shopify admin, Giveaway Gator will calculate entries for it.

How do I pick a winner?

Open the promotion, click Winners, then Draw winners. Choose how many winners, whether the same customer can win more than once, and an optional date range. Giveaway Gator draws winners weighted by their valid entries and saves every draw. Before you draw, check the acknowledgement that this tool randomly selects winners from your Giveaway Gator entries and is not a third-party sweepstakes administrator. If your official rules or jurisdiction require an independent administrator, export your entries to CSV for that administrator. See Section 25: Drawing Winners.

Is Giveaway Gator a third-party sweepstakes administrator?

No. Before each draw, you check this acknowledgement: “I understand this tool randomly selects winners from my Giveaway Gator entries and is not a third-party sweepstakes administrator. I’m responsible for my giveaway’s official rules and legal compliance.” The winner picker is not a third-party sweepstakes administrator. If your official rules or jurisdiction require an independent administrator, export your entries to CSV for that administrator.

Can I add manual entries?

Yes. You can add manual entries from within the app (Promotion > Entries > Manual Entry) or via the Manual Entries API for system integrations.

Can I restore an invalid entry?

Yes. Open the promotion, go to Entries, and revalidate a single entry or a selected group. You’ll be asked for a required note explaining why — that note is saved on the entry history. After you restore an entry, a later order sync won’t undo it just because payment had previously failed or been voided. Refunded or cancelled orders can still make the entry invalid again.

My entry badges are showing 0 — what’s wrong?

This is usually caused by: 1) The app embed not being enabled — toggle it on in Online Store > Themes > Customize > App embeds. 2) A product variable mismatch — the entry tag uses a variable like card_product.id which must match your theme’s variable. 3) An empty or invalid data-price attribute. 4) No active promotion. See Section 11: Displaying Entries on Product Cards for full troubleshooting steps.

Entry tags stopped working after a theme update — what should I do?

Theme updates can overwrite custom code. Check that the entry tag snippet is still in your product card template, verify the product variable still matches, and make sure the app embed is still enabled. Contact support for free reinstallation help.

Entries aren’t syncing automatically — how do I fix this?

Check webhook status in Giveaway Gator > Settings and use detach/reattach to reset if needed. Verify you have an active promotion, and try a manual resync. Webhooks are self-healing but may need a manual reset after platform updates.

Can I run more than one promotion at the same time?

Yes. Every order earns entries in all active promotions. Customers do not have to choose. If two promotions run at the same time, give them the same multiplier so customers see one clear number. Promotions limited to specific products do not need to line up. See Running Multiple Promotions.

Does Giveaway Gator work with subscription apps?

Yes. Subscription orders are processed like any Shopify order. For fixed bonus entries per subscription, set the product multiplier to 0 and add a bonus entry amount instead.

Which features require Shopify Plus?

None. Giveaway Gator works on every Shopify plan — including the thank-you page extension, entry tags, countdown timers, Entry Checker, and the rest of the feature set. Note: “Shopify Plus” is your store’s Shopify subscription, separate from your Giveaway Gator plan (Unlimited or Unlimited Pro). You do not need Shopify Plus to use Giveaway Gator.

What plans does Giveaway Gator offer?

Three plans:

  • Unlimited ($199/month) — every giveaway and storefront feature: promotions, bonuses, multipliers, storefront blocks, POS claims, Shopify Flow, and the API. Unlimited orders and entries, in-app live chat, a 1:1 onboarding session, and a free trial.
  • Unlimited Pro ($299/month) — everything in Unlimited, plus customer analytics, post-purchase surveys, post-purchase actions, product restricted promotions, and order tag bonuses.
  • Pause Your Plan ($5/month) — between giveaways; active subscription, not a cancellation. View and export entries and open the winners page. No creating or editing giveaways while paused.

See Section 24: Plans & Pricing and Section 27: Pausing Your Plan.

What support is included?

Both plans include in-app live chat support and a 1:1 onboarding session, plus email support at support@support.giveawaygator.app.


22. Post-Purchase Surveys (Unlimited Pro)

Reward customers with bonus entries for answering a short survey after they buy — to collect feedback, measure satisfaction (rating and NPS), capture birthdays, and learn who your customers are.

Setup

  1. Open Giveaway Gator > Surveys and click Create survey.
  2. Set a title, description, and entry reward (default 100).
  3. Add questions. Types: single choice, multiple choice, short text, long text, rating (1–5), NPS (0–10), and birthday. Each question can be required, can randomize its options, and can apply a customer tag from the answer.
  4. Save as a draft, then switch the status to active. Once active, it automatically appears on the thank-you page and the order status page for every promotion — placement and audience are handled for you.

Reviewing results

Open a survey and click Results for total responses, completion rate, impressions, and entries awarded. Each question shows a fitting breakdown (bar charts, average rating, NPS with Promoter/Passive/Detractor split, paged text answers, birthday distribution). Filter by audience segments (presets like New entrants, Repeat purchasers, Loyalists, High spenders, plus custom rules), compare two segments side by side, filter by date, and export all responses to CSV.

Each customer can complete a survey once; answering on one page means it won’t ask again on the other.


23. Post-Purchase Actions (Unlimited Pro)

Give customers more ways to earn entries after checkout — buttons on the thank-you page that reward social follows, custom actions, and (coming soon) referrals.

Action types

  • Social Visit — Facebook, Instagram, TikTok, or a custom link. Set a button label, the link, and the entry reward. The link opens in a new tab and entries are awarded.
  • Custom Webhook — connect an outside service that confirms the action and awards entries. Requires an API key, configured under Settings.
  • Referral — coming soon.

Setup

  1. Open Giveaway Gator > Post-Purchase Actions and click Create action.
  2. Choose the type, set the button label, link, and entry reward.
  3. Choose Once per User (Global) or Once per Order (awards again on each new order the customer completes).
  4. Save and toggle it on.

Actions are shared across your store, so they appear on the thank-you page for every promotion. Only actions you’ve turned on are shown. They show inside Giveaway Entries Confirmation while Show bonus actions is on. To place them somewhere else, add the Giveaway Bonus Actions block, then turn Show bonus actions off so customers do not see the actions twice.


24. Plans & Pricing

Giveaway Gator has three plans: Unlimited and Unlimited Pro for running giveaways, and Pause Your Plan ($5/month) for between giveaways. Unlimited and Unlimited Pro include unlimited orders and entries, in-app live chat support, a 1:1 onboarding session, and a free trial.

Plan Price
Unlimited $199/month
Unlimited Pro $299/month
Pause Your Plan $5/month

Unlimited — $199/month

Every giveaway and storefront feature: promotions, bonus periods, super bonuses, order bonuses, bonus discount codes, order multiplier products, all storefront blocks (entry tags, countdown timers, progress bars, Entry Checker), thank-you and order status entry displays, the order confirmation email image, POS receipt claims, Shopify Flow, the REST API, manual entries, CSV export, the in-app winner picker, and audit logs.

Unlimited Pro — $299/month

Everything in Unlimited, plus:

  • Customer analytics — cohort and segment insights on your Customers page
  • Post-purchase surveys (Section 22)
  • Post-purchase actions (Section 23)
  • Product restricted promotions — limit a promotion to specific products
  • Order tag bonuses — flat entries and/or a multiplier when an order has a Shopify tag (Section 26)

Change between Unlimited and Unlimited Pro anytime under Giveaway Gator > Settings.

Pause your plan (summary)

Between giveaways, switch to Pause Your Plan from Settings > Manage plan. It costs $5 a month, stays an active paid subscription (not a cancellation), and keeps your giveaways, entries, and history. While paused you can view and export entries and open the winners page; you cannot create or edit giveaways or use Pro features or in-app live chat. Click Reactivate subscription to return to Unlimited or Unlimited Pro. Full details: Section 27: Pausing Your Plan.


25. Drawing Winners

When a promotion is ready, you can draw winners inside Giveaway Gator. The draw is weighted by entries, takes one click, and every draw is saved for your records. The winner picker is included on every plan.

Giveaway Gator does not email or notify the winners. After a draw, you contact them.

You can still export all entries to CSV for your sweepstakes administrator. There isn’t a separate winners file. The entries export is the compliance record.

How to Draw Winners

  1. Open Giveaway Gator and open the promotion.
  2. Click Winners, then Draw winners.
  3. Choose how many winners to draw.
  4. Choose whether the same customer can win more than once.
  5. Optionally, limit the draw to a date range.
  6. Check the acknowledgement. You can’t draw until you do.
  7. Draw the winners.

If the promotion is still running, you’ll see a warning that entries added later won’t be in this draw. You can still run the draw.

Before You Draw

Before the draw runs, you check this acknowledgement:

I understand this tool randomly selects winners from my Giveaway Gator entries and is not a third-party sweepstakes administrator. I’m responsible for my giveaway’s official rules and legal compliance.

The winner picker in Giveaway Gator is not a third-party sweepstakes administrator. If your official rules or jurisdiction require an independent administrator, export your entries to CSV for that administrator.

Who Can Win

Only valid entries that have an email address are included.

  • Invalid entries are left out. Entries that were invalidated — for example, from refunded or cancelled orders — can’t win.
  • Entries without an email are left out. A POS order the customer never claimed has no email, so it can’t win.

Entries are grouped by email address, and the match ignores capitalization. One customer with several orders is a single entrant. Their weight is all of their valid entries combined.

How Weighting Works

Giveaway Gator draws with cryptographically secure randomness, weighted by entries. Each customer’s chance is proportional to their total valid entries.

A customer with 200 valid entries is twice as likely to be drawn as a customer with 100. More entries mean a better chance.

Repeat Winners

When you draw, you choose whether the same customer can win more than once. If you allow it, one customer can take more than one spot in the same draw. If you don’t, each winning spot goes to a different customer.

Date Range

You can optionally limit the draw to a date range. Only eligible entries in that range go into the pool.

The Draw Record

Every draw is saved. You can reopen past draws from the Winners page.

Each record includes:

  • The date of the draw
  • The settings you chose (how many winners, whether the same customer can win more than once, and the date range if you set one)
  • The number of eligible entrants
  • The total entries in the pool
  • The method
  • The winners, in order, with each winner’s entry count

After You Draw

Each winner shows their email, name, and phone, plus a link to the Shopify customer when Giveaway Gator finds one.

To see which orders earned their entries, filter the entries page by that email, or export and filter by that email. Each entry row shows its order number.

FAQ

Is it fair or random? Yes. Giveaway Gator uses cryptographically secure randomness, so the result can’t be predicted. The draw is weighted by entries: each customer’s chance is proportional to their total valid entries.

Why isn’t a POS customer in the draw? Only valid entries with an email address are included. A POS order the customer never claimed has no email on the entry, so it can’t win. Invalidated entries, such as refunded or cancelled orders, are left out too.

Can I redraw? Yes. You can run another draw whenever you need to. Every draw is saved, including earlier ones, and you can reopen any of them from the Winners page.

Is Giveaway Gator a sweepstakes administrator? No. Before you draw, you acknowledge that this tool randomly selects winners from your Giveaway Gator entries and is not a third-party sweepstakes administrator. You’re responsible for your giveaway’s official rules and legal compliance. If your rules or jurisdiction require an independent administrator, export your entries to CSV for that administrator.


26. Order Tag Bonuses (Unlimited Pro)

Order tag bonuses award extra entries when a Shopify order has a tag you choose. If the order has the tag, Giveaway Gator applies the bonus on that rule — a flat number of entries, a multiplier, or both. Included with Unlimited Pro.

Why Use Them

  • Reward VIP, wholesale, or other orders you already tag in Shopify
  • Cover orders that arrive with a tag, including orders from a headless storefront once that tag is on the Shopify order
  • Keep the rule simple: if the order has this tag, apply this bonus

Shopify Flow can add the tag for you.

Setup

  1. Open Giveaway Gator and go to Order Tag Bonuses.
  2. Create a rule for the Shopify order tag (for example, VIP or wholesale).
  3. Set flat bonus entries, a multiplier greater than 1, or both.
  4. Save the rule.

How It Calculates

The normal calculation runs first (base entries, product bonuses, bonus periods, order bonuses, and discount codes). Then:

  1. Flat entries from every matching tag are added together.
  2. If any matching tag has a multiplier greater than 1, the highest one is applied once.

Matching is case-insensitive and uses the order’s tags only. A tag added later is included the next time the order updates. The new total replaces the saved total.

A purchased Super Multiplier still multiplies after the tag bonus. A purchased Upgrade multiplier skips order tag bonuses.

Example: A $10 order at $1 per entry during a 5× bonus period earns 50 entries. With a matching 2× tag multiplier, the customer earns 100 entries. With no matching tag, they earn 50.


27. Pausing Your Plan

Pause Your Plan is for the time between giveaways. It is still an active paid subscription at $5 a month. It is not a cancellation. Your giveaways, entries, and history stay in Giveaway Gator.

Pause Your Plan is a Giveaway Gator plan. It is not Shopify’s Pause and Build plan for your store.

How to pause

  1. In your Shopify admin, open Giveaway Gator > Settings.
  2. Click Manage plan.
  3. Choose Pause Your Plan.
  4. Approve the change if Shopify asks you to.

What you can still do

While your plan is paused, you can:

  • View entries
  • Export entries
  • Open the winners page

What stays off while you are paused

You cannot:

  • Create or edit giveaways
  • Change bonus periods, discount codes, multipliers, or other bonus features
  • Import entries

Unlimited Pro features are off. In-app live chat is off. A bonus code redeemed while your plan is paused does not add entries.

You can still email support@support.giveawaygator.app.

How to turn your plan back on

Reactivate subscription is on Settings, on the paused banner, and in the pop-ups that appear when a change is locked.

  1. Click Reactivate subscription.
  2. Shopify opens the plan page in your admin.
  3. The Settings banner names the last plan you were on. If none is on record, it names Unlimited.
  4. Pick a plan and approve the charge in Shopify.

If you decline the charge, you stay on Pause Your Plan. Settings says the charge was not approved. Your giveaways and entries are unchanged.

If you approve the charge, Giveaway Gator unlocks on the plan Shopify reports. Settings confirms that creating and editing giveaways is unlocked.

If the plan page cannot open, or Giveaway Gator cannot confirm the new plan, Settings shows an error. Reactivate subscription stays available. Try again, or contact support.


Known Issues & Notes

Duplicate Documentation Pages

  • “How to Get Setup?” and “How to Set Up?” were near-duplicate pages in Notion. Content has been consolidated into Section 2 above.

Pages Marked Under Construction

  • Order Bonus Progress Bar documentation is marked as “under construction” in Notion.

Pages with Video-Only Content

  • Thank You Page documentation (Section 13) had only a video walkthrough with no text content.

Last compiled: October 6, 2026

Type to search…

↑↓ navigate↵ selectEsc close