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
