Skip to content

Giveaway Gator — Support Topics

This page maps common merchant questions and issues to the right help articles.


Getting Started & Setup

What is Giveaway Gator and how does it work? Giveaway Gator is a Shopify app that automatically calculates sweepstakes entries based on customer purchases. → What Is Giveaway Gator?

How do I set up Giveaway Gator for the first time? Install from the Shopify App Store, create a promotion, set your dollar-per-entry rate, and enable the app embed. → Initial Setup

Will I get a welcome email after installing? Yes. New installs get one email from Giveaway Gator titled “Finish setting up Giveaway Gator.” with a link into the app to finish setup and create your first promo. It only sends once. → Initial Setup

What should I check before launching my first promotion? Verify your promotion dates, timezone, dollar-per-entry rate, and that the app embed is enabled. → Initial Setup

How do I enable the app embed on my Shopify theme? Go to Online Store → Themes → Customize → App embeds, and toggle Giveaway Gator on. → Initial Setup


Entry Math & Calculations

How are entries calculated from an order? You set a dollar-per-entry rate. A $50 order at $1/entry earns 50 base entries. Bonuses and multipliers stack on top. → How Entry Math Works

Why did a customer get fewer entries than expected? Entry math uses whole dollars only — $9.99 at $1/entry = 9 entries, not 10. Multipliers also follow a priority hierarchy. → How Entry Math Works

What is the bonus hierarchy? Which multiplier takes priority? Product Bonus Periods > Super Bonuses > Default Bonus Period Multiplier > Order Bonuses > Discount Code Bonuses > Order Tag Bonuses > Order Multiplier Products. → How Entry Math Works

Do entries sync automatically from Shopify orders? Yes. Giveaway Gator processes orders in real-time via webhooks. → FAQs

What about refunded or cancelled orders? Entries are automatically adjusted when orders are refunded or cancelled. → FAQs

Do post-purchase upsells count toward entries? Yes. Post-purchase upsell amounts are included in entry calculations automatically. → FAQs

Do TikTok Shop, Meta, or other sales channel orders earn entries? Yes. Any order that appears in your Shopify admin earns entries automatically. → FAQs


Promotions

How do I create a promotion? Open Giveaway Gator in Shopify, click Create Promotion, and set the name, dollar-per-entry rate, timezone, and start and end dates in the create modal. The modal saves those dates. → Initial Setup

Where are the product list, order list, and entries for a promotion? Open the promotion. The title bar has actions for the product list, the order list, and entries. → Initial Setup

How do I find a promotion in the list? The promotions list uses Shopify’s filters and table rows. Filter the list, then open a row. → Running Multiple Promotions

Can I run multiple promotions at the same time? Yes. Every order earns entries in all active promotions simultaneously. → Running Multiple Promotions

Can I edit a promotion after it starts? Yes. Changes apply to future orders. Use resync to apply changes retroactively. → FAQs

What happens when a promotion ends? It stops accepting new entries. Existing entries are preserved for export and management. → FAQs

How do I resync entries after changing settings? Go to your promotion and click Resync. This recalculates entries for all orders in the promotion period. → FAQs

How does timezone handling work for promotions? All calculations respect the promotion’s timezone setting. Bonus periods activate at midnight in the promotion’s timezone, not UTC. → FAQs

Where do I find my Promotion ID? Open Giveaway Gator, click Manage on a promotion, and copy the ID from the URL. → FAQs


Bonus Periods

What are bonus periods and how do they work? Bonus periods multiply all entries during a specific timeframe — like “2X entries this weekend.” → Bonus Periods

Why does my bonus period show “Upcoming” when it should be active? Bonus periods activate based on the promotion’s timezone, not your local time. Check your promotion timezone setting. → Bonus Periods

Can I change multipliers week-to-week? Yes. Create separate bonus periods for each week with different multipliers. → Bonus Periods

My bonus period dates are outside the promotion dates — will it still work? Bonus periods outside the promotion date range won’t affect orders. Make sure bonus period dates fall within the promotion’s start and end dates. → Bonus Periods


Order Bonuses

What are order bonuses? Order bonuses award flat bonus entries when counted product lines reach a threshold — like “50 bonus entries when those lines add up to $100.” Shipping, tax, and 0x products are left out. → Order Bonuses

What’s the difference between a bonus period and an order bonus? Bonus periods multiply entries by a set amount. Order bonuses add a flat number of entries when counted product lines reach a threshold. They can stack. → Order Bonuses


Order Tag Bonuses

What are order tag bonuses? On Unlimited Pro, an order tag bonus awards extra entries when the order has a Shopify tag you choose. A rule can add flat entries, apply a multiplier, or both. → Order Tag Bonuses

What if an order has more than one matching tag? Flat entries from each matching tag are added together. Only the highest tag multiplier is applied, and it is applied once. → Order Tag Bonuses


Discount Code Bonuses

How do discount code bonuses work? Add your Shopify discount codes to Giveaway Gator and assign bonus entries to each one. When a customer uses the code, they earn bonus entries on top of regular entries. → Bonus Discount Codes

Can I use discount codes to reward email signups or social media followers? Yes. Share a bonus discount code with subscribers or followers. When they use it at checkout, they earn bonus entries. → Bonus Discount Codes


Order Multiplier Products

What are Order Multiplier Products? Virtual products customers add to their cart to multiply their entries. Multiplier Upgrades replace the current multiplier. Super Multipliers multiply the final entry count. → Order Multiplier Products

What’s the difference between an Upgrade and a Super Multiplier? An Upgrade replaces all other multipliers with its value. A Super Multiplier multiplies the final total after all other calculations. → Order Multiplier Products


Storefront Features

Entry Tags on Product Cards

How do I show entries on product pages and collection pages? Add the Giveaway Entry Tag app block in the theme editor — no code on Horizon and newer themes. Older themes use a small code snippet for collection cards. → Entries on Product Cards

How do I show thousand separators on entry counts? In the theme editor, open App embeds, select Giveaway Gator, and enable Use thousand separators. It stays off until you turn it on. A tag or section can override that with data-gg-thousands. The tag wins over the section, and the section wins over the app embed setting. The entry count used for the giveaway does not change. → Entries on Product Cards

How do I preview my storefront blocks without a live giveaway? Turn on Preview mode in the Giveaway Gator app embed in the theme editor — it fills entry tags and countdowns with sample data and never affects your live store. → Test Mode

My entry tags are showing “0 entries” — how do I fix this? Usually a product variable mismatch. Your theme may use “product” instead of “card_product”. Check your theme’s product card file for the correct variable. → Entries on Product Cards

Entry tags stopped working after a theme update — what do I do? Theme updates can overwrite custom code and change variable names. Re-add the entry tag snippet and verify the product variable matches your updated theme. → Entries on Product Cards

How do I find the right product variable for my theme? Open your theme’s product card template and look for references to the product’s price or title. The variable used there is the one you need. → Entries on Product Cards

Countdown Timer

How does the countdown timer work? The timer shows the current bonus multiplier. It counts down to the active bonus period when one is running, and to the giveaway end otherwise. Add it as an app block in the theme customizer, or drop a timer tag into page content. → Countdown Timer

Can the timer count down to the giveaway end instead of the bonus period? Yes. Add data-gg-end="promo" on a text timer, timer boxes, or the progress bar. If the giveaway has no end date, or that date has passed, the timer stays hidden. → Countdown Timer

The countdown timer is showing the wrong promotion or multiplier — why? With multiple active promotions, the timer may display a different promotion’s bonus. Align bonus periods across promotions for consistent display. → Countdown Timer

Can I show just the multiplier without a countdown? Yes. Use only multiplier variables in the template without time variables. The element renders once without ticking. → Countdown Timer

Countdown Progress Bar

What is the countdown progress bar? A visual progress indicator for the same end time as the countdown timer. Add data-gg-end="promo" to always use the giveaway end. → Countdown Progress Bar

Entry Checker

How do customers check their entries? Add the Entry Checker block to a page on your store. Customers enter their email to see their total entries and order breakdown. → How Customers See Entries

The Entry Checker isn’t finding a customer — what’s wrong? The Entry Checker searches by the email used at checkout, not the customer’s account email. Make sure they’re entering the exact email from their order. → How Customers See Entries

Can customers search by phone number? No. The Entry Checker only supports email lookup. → How Customers See Entries

Entries don’t appear in the Entry Checker after the promotion ended — why? The Entry Checker only shows entries for active promotions. Keep the promotion active if you want customers to still look up their entries. → How Customers See Entries

Thank You Page

What do customers see after checkout? The thank-you page extension shows how many entries they earned from their order, broken down by promotion. → Thank You Page

How do I put bonus actions in their own spot on the thank-you page? Add the Giveaway Bonus Actions app block on the thank-you page (Settings > Checkout > Thank you page). Then turn off Show bonus actions on Giveaway Entries Confirmation so customers do not see the actions twice. → Thank You Page

Order Status Page

Can customers see entries on the order status page? Yes. The order status extension displays entry counts for the order. → Order Status Page

Order Confirmation Email

Can I show entries in the order confirmation email? Yes. Giveaway Gator generates a branded image you add to your Shopify order confirmation email template. → Order Confirmation Email

Post-Purchase Surveys & Actions (Unlimited Pro)

Can I survey customers after they buy? Yes, on Unlimited Pro. Build a survey that appears on the thank-you and order status pages and rewards bonus entries. Review answers with charts, segments, comparisons, and CSV export. → Post-Purchase Surveys

Can I reward customers for following us, referring friends, or other actions? Yes, on Unlimited Pro. Post-purchase actions add buttons to the thank-you page that award entries for social follows, custom actions, or referrals (coming soon). Place them with Giveaway Bonus Actions, or leave Show bonus actions on inside Giveaway Entries Confirmation. → Post-Purchase Actions

Can I tag customers based on their survey answers? Yes. Each survey question can apply a customer tag from the answer — like tagging a 5-star rating or a birthday month — to build audiences for later. → Post-Purchase Surveys


POS (Point of Sale)

Does Giveaway Gator work with Shopify POS? Yes. Customers can claim entries from in-store purchases by entering their receipt number on your website. → POS Claim Block

How does POS entry claiming work? Add the POS Claim block to a page. Customers enter their receipt number and email to claim entries from in-store purchases. → POS Claim Block


Managing & Exporting Entries

How do I pick a winner? Open the promotion, click Winners, then Draw winners. Giveaway Gator draws winners in one click, weighted by entries, and saves every draw. Before you draw, you confirm the picker is not a third-party sweepstakes administrator. If your rules require an independent administrator, export entries to CSV for them. → Drawing Winners

How do I export entries? Go to your promotion’s Entries tab and click Export Entries. Export all, a date range, or selected entries as Excel/CSV. Exports include City and State from the order billing address when present (blank for digital or API entries). → Exporting Entries

How do I add entries manually? Go to your promotion, click the Entries tab, then Add Manual Entry. You need the customer’s email and entry count. → Manual Entries

Can I restore an invalid entry? Yes. Open the promotion, go to Entries, and revalidate one entry or several at once. You’ll add a required note that’s saved on the entry history. A later order sync won’t undo the restore just because payment had previously failed or been voided; a later refund or cancellation still can. → Manual Entries

Can I test entry calculations before going live? Yes. Test Mode lets you preview calculations with simulated data without processing real orders. → Test Mode


Integrations

Does Giveaway Gator work with Shopify Flow? Yes. Use the Add Entries action in Flow to award entries for signups, reviews, loyalty milestones, or any other Flow trigger. → Shopify Flow

Can I award entries for email signups, reviews, or loyalty actions? Yes, via Shopify Flow. Set up a Flow automation with the relevant trigger and the Giveaway Gator “Add Entries” action. → Shopify Flow

Can I integrate with Klaviyo? No direct integration, but Klaviyo signup forms create Shopify customer records, which can trigger Shopify Flow to award entries. → FAQs

Does it work with subscription apps like Appstle or Recharge? Yes. Subscription orders are processed like any Shopify order, so entries calculate automatically on each recurring charge. → FAQs

Can I use Giveaway Gator with a headless storefront? Yes. Full API support for Hydrogen, custom storefronts, and headless builds. → API Reference


Shopify Admin Extensions

What is the Product Bonuses block in Shopify admin? A block that appears on the Shopify product detail page showing any active bonuses configured for that product. → Product Bonuses Block

What is the Order Entries block in Shopify admin? A block on the Shopify order detail page showing how many entries that order generated. → Order Entries Block


Developer & API

Is there an API for creating entries programmatically? Yes. The REST API supports creating entries, looking up customers, and managing promotions. → API Reference

How do I use the Manual Entries API? Send one JSON POST to https://giveawaygator.app/api/entries/create with a promotion ID, an entry count greater than 0, and an email or phone. Use your API key as a Bearer token. There is no bulk call. → Manual Entries API

Is there an API for POS entry claims? Yes. The POS Claim API lets you build custom claim flows for in-store purchases. → POS Claim API


Troubleshooting

Entries aren’t syncing — orders aren’t generating entries. Check webhooks (Settings → detach/reattach), verify the promotion is active with correct dates, and try a resync. → FAQs

Entry tags show “0 entries” on product pages. Usually a product variable mismatch in the theme code. Check your theme’s product card template for the correct variable name. → Entries on Product Cards

Entry tags disappeared after a theme update. Theme updates overwrite custom code. Re-add the entry tag snippet and re-enable the app embed. → Entries on Product Cards

The app shows a blank screen in Shopify admin. Try clearing your browser cache, using incognito mode, or a different browser. Check Shopify’s status page for outages. → FAQs

The countdown timer shows the wrong multiplier or promotion. The timer shows one site-wide promotion. Promotions limited to specific products are left out. Among site-wide promotions with a bonus running right now, the one that ends first wins. If two end at the same time, the higher multiplier wins. 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. Give overlapping site-wide promotions the same multiplier so customers see one clear number. This runs automatically, nothing to set. → Running Multiple Promotions

Bonus period isn’t activating at the expected time. Bonus periods use the promotion’s timezone setting, not your local timezone. Check your promotion timezone. → Bonus Periods

Customer can’t find entries in the Entry Checker. Make sure they’re searching with the exact email from their checkout, not their account email. → How Customers See Entries

Can I show entries on the cart page? Not through the theme editor. This requires custom theme code — contact support for help. → FAQs

Which features require Shopify Plus? None. Giveaway Gator works on every Shopify plan. “Shopify Plus” is your store’s Shopify subscription, separate from your Giveaway Gator plan. → FAQs


Billing & Support

Is there a free trial? Yes. Giveaway Gator includes a free trial to set up and test before committing. → FAQs

What plans does Giveaway Gator offer? Three: Unlimited ($199/month) with every giveaway and storefront feature; Unlimited Pro ($299/month) which adds customer analytics, post-purchase surveys and actions, product restricted promotions, and order tag bonuses; and Pause Your Plan ($5/month) between giveaways to keep your data without running a promotion. Unlimited and Unlimited Pro include live chat, 1:1 onboarding, and a free trial. → Plans & Pricing

How do I pause my plan? Open Giveaway Gator > Settings, click Manage plan, and choose Pause Your Plan ($5 a month). It is still an active paid subscription, not a cancellation. Your giveaways, entries, and history stay in the app. You can view entries, export entries, and open the winners page. You cannot create or edit giveaways, change bonus features, or import entries. → Pausing your plan

How do I turn a paused plan back on? Click Reactivate subscription on Settings, on the paused banner, or in a paused pop-up. Shopify opens the plan page. The Settings banner names your last plan, or Unlimited if none is on record. Pick a plan and approve the charge. If you decline, you stay on Pause Your Plan and your giveaways and entries are unchanged. If you approve, the app unlocks on the plan Shopify reports. If the plan page cannot open, or the new plan cannot be confirmed, try again or contact support. → Pausing your plan

How do I cancel or change my plan? Uninstall the app to cancel, or go to Settings to change plans. Pausing is a $5 a month subscription, not a cancellation. → FAQs

How do I get help? Use the in-app support chat or email support@support.giveawaygator.app. → Contact Support

Type to search…

↑↓ navigate↵ selectEsc close