# Giveaway Gator Help Center > Giveaway Gator is a Shopify app for running automated sweepstakes/giveaway promotions with entry calculation, bonus periods, multipliers, and storefront/admin extensions; this help center documents setup, entry math, features, and the developer API. ## Getting Started - [What Is Giveaway Gator?](https://docs.giveawaygator.app/what-is-giveaway-gator.md): Shopify app for automated sweepstakes/giveaway promotions: entries per order, bonus periods, multipliers, discount code bonuses, cross-channel order processing, and the Unlimited ($199/mo) vs Unlimited Pro ($299/mo) plan feature split. - [How Entry Math Works](https://docs.giveawaygator.app/entry-math.md): Explains the 7-step hierarchical entry calculation order: base entries from dollar-per-entry rate, product bonus priority (bonus periods > super bonuses > default multiplier), bonus period multipliers, order spending-threshold bonuses, discount code bonuses, checkout bonuses (Unlimited Pro/Plus), and order multiplier products, with a worked example. - [Getting Started / Initial Setup](https://docs.giveawaygator.app/getting-started.md): Covers creating a promotion (name, dollar-per-entry, dates, timezone), enabling the storefront app embed and blocks (entry tag, thank you page, entry checker, timers, progress bar, POS claim), and optional bonus periods. - [Contact Support](https://docs.giveawaygator.app/support.md): Describes the merchant support contact page: a form and email address for reaching Giveaway Gator support, plus an Unlimited Pro upsell banner. ## Promotions & Bonuses - [Super Bonuses vs. Product Bonus Periods](https://docs.giveawaygator.app/product-bonus-types.md): Explains the difference between permanent shop-wide Super Bonuses and time-limited, per-promotion Product Bonus Periods, including their priority order and setup steps. - [Bonus Periods](https://docs.giveawaygator.app/bonus-periods.md): Setting up, editing, and troubleshooting time-based entry multipliers (bonus periods) within a promotion, including date-range validation and cross-promotion multiplier precedence. - [Order Bonuses](https://docs.giveawaygator.app/order-bonuses.md): Flat bonus entries awarded when an order total meets a configurable dollar threshold, with optional tiering and time-limited windows within a promotion. - [Bonus Discount Codes](https://docs.giveawaygator.app/bonus-discount-codes.md): Configuring Shopify discount codes that award extra giveaway entries, including setup steps, stacking multiple codes, and managing existing codes. - [Order Multiplier Products](https://docs.giveawaygator.app/order-multipliers.md): Sellable Shopify products (Upgrade or Super type) that multiply a customer's giveaway entry count, including setup, management, and their exact place in the entry calculation hierarchy. - [Running Multiple Promotions](https://docs.giveawaygator.app/multiple-promotions.md): Explains that orders earn entries independently across all concurrently active promotions (each with its own rate, bonuses, and periods), and warns that differing bonus-period multipliers across promotions can cause misleading product entry tag displays. ## Storefront Display - [Displaying Entries on Product Pages & Product Cards](https://docs.giveawaygator.app/product-entry-tags.md): Documents how to add the Giveaway Entry Tag app block (or a code snippet on older themes) to product pages and collection product cards to display base/bonus entry counts, plus CSS customization, test mode, and troubleshooting. - [How Customers See Their Entries](https://docs.giveawaygator.app/entry-checker.md): Documents the storefront Entry Checker block: customers look up giveaway entries by email, view total/breakdown/previous-promotion data, setup steps in the theme editor, and configurable settings (title, description, placeholder, button text, previous-promotions toggle, table colors). - [POS Claim Block](https://docs.giveawaygator.app/pos-claim.md): Theme block and workflow letting customers submit a POS receipt number and email on-site to match their in-store Shopify order and receive giveaway entries, with setup steps and customization options. - [Countdown Timer](https://docs.giveawaygator.app/countdown-timer.md): Configuration of the data-gg-countdown-timer HTML embed, its template variables, multiplier-only static display mode, CSS variables, update/revalidation behavior, and multi-promotion multiplier selection logic. - [Countdown Progress Bar](https://docs.giveawaygator.app/countdown-progress-bar.md): Configuration and implementation reference for the countdown progress bar component: fill logic, animation types, install methods (theme block, class-based liquid, attribute-based), CSS custom properties, and page-builder integration. - [Thank You Page Entries Display](https://docs.giveawaygator.app/thank-you-page.md): Order confirmation page extension that shows a customer's total earned entries, enabled via the Shopify theme editor. - [Order Status Page — Order Entries](https://docs.giveawaygator.app/order-status-entries.md): Order status page block that displays a customer's giveaway entry count and promotion name(s) for a given order, with configurable header icon, footer message/icon/color/border, and multi-promotion breakdown. ## Post-Purchase & Engagement - [Post-Purchase Surveys](https://docs.giveawaygator.app/surveys.md): Configuring post-purchase surveys with bonus-entry rewards, question types, tagging, placement, results/segments, and CSV export. - [Post-Purchase Actions](https://docs.giveawaygator.app/post-purchase-actions.md): Configurable post-checkout bonus-entry actions (social visit, custom webhook, referral) shown as buttons on the thank-you page, with once-per-user or once-per-order reward limits. ## Email Integration - [Order Confirmation Email](https://docs.giveawaygator.app/order-confirmation-email.md): Documents the order confirmation email feature: a generated PNG image showing a customer's giveaway entry count, embedded via HTML snippet in Shopify's order confirmation notification template, with customization options and optional linking to the entry checker page. ## Managing Entries - [Exporting Entries](https://docs.giveawaygator.app/exporting-entries.md): Covers exporting promotion entries to CSV from the Entries view (all/filtered, date-range, or selected-only), and the resulting columns: email, name, order number, amount, total entries, valid status, created at. - [Manual Entries](https://docs.giveawaygator.app/manual-entries.md): How to add manual (non-order) entries to a promotion in-app with email, name, reason, and entry count, and how to filter the entries list to show only manual entries. - [Test Mode - Preview Before Going Live](https://docs.giveawaygator.app/test-mode.md): Covers theme-editor Preview mode (sample data toggle for styling blocks) and the window.GiveawayGator.test() browser-console tool for simulating live promotions with configurable bonus periods, multipliers, and product bonuses on the real storefront. ## Shopify Admin Extensions - [Product Bonuses Admin Block (Shopify Admin)](https://docs.giveawaygator.app/product-bonuses-admin.md): Configuring per-product Super Bonuses (entry multipliers and flat bonus entries) via a block embedded on Shopify product pages. - [Order Entries Admin Extensions (Shopify Admin)](https://docs.giveawaygator.app/order-entries-admin.md): Shopify order-detail admin extensions showing per-order entry counts/promotion breakdown and a full entry-calculation audit log (multipliers, bonus periods, product/order bonuses, final total). ## Integrations - [Shopify Flow Integration](https://docs.giveawaygator.app/shopify-flow.md): Documents the Giveaway Gator Shopify Flow integration, specifically the "Add Entries" action (fields: customer email, name, promotion ID, entry count, notes), example workflows (email signup, loyalty milestones, VIP order-based entries, product reviews, birthdays), how Flow-sourced entries are labeled and logged, and setup tips. ## Developer / API - [API Reference](https://docs.giveawaygator.app/api-reference.md): Documents the Giveaway Gator REST API: base URL, API key authentication, rate limits (60 req/min), and the common JSON response/error format. - [Manual Entries API](https://docs.giveawaygator.app/manual-entries-api.md): Documents the POST /api/v2/promos/[id]/manual-entry endpoint for adding manual promotion entries from external systems, including required fields, auth, and response formats. - [POS Claim External API](https://docs.giveawaygator.app/pos-claim-api.md): POST /api/theme/pos-claim endpoint letting customers claim giveaway entries from a POS receipt, covering auth, rate limits, request/response schema, and status codes. ## Standalone - [FAQs](https://docs.giveawaygator.app/faqs.md): Answers common merchant questions on setup, entry calculation, promotions, bonuses/multipliers, storefront extensions, integrations (Flow, POS, headless, Klaviyo, subscriptions), reliability, exporting, troubleshooting, and billing/plans. - [Giveaway Gator — Support Topics](https://docs.giveawaygator.app/support-topics.md): Maps common merchant questions/issues (setup, entry math, promotions, bonuses, storefront blocks, POS, exports, integrations, admin extensions, API, troubleshooting, billing) to their corresponding help articles. ## Full Reference - [Master Help Document](https://docs.giveawaygator.app/master-help-document.md): single-file comprehensive reference covering every feature. - [Chatbot Knowledge Base](https://docs.giveawaygator.app/chatbot-knowledge-base.txt): plain-text corpus used by the in-app support chatbot; good for bulk ingestion.