How can we help?

The Winners tab is where you select and manage contest winners. How you select winners depends on the method you chose during contest setup. Winner Stats At the top of the Winners tab, you'll see: - Total entries — All entries submitted to this contest - Eligible entries — Entries that haven't already won a prize - Winners selected — How many winners you've picked so far Random Draw If your contest uses the random draw method: 1. Go to the Winners tab. 2. Select which prize to draw a winner for from the dropdown. 3. The available quantity shows how many more winners can be drawn for that prize. 4. Click Draw winner. 5. The system randomly selects an eligible entry and assigns them the prize. How randomization works: - Each eligible entry has a chance proportional to their total entry count. An entry with 3 total entries has three times the chance of being selected compared to an entry with 1. - Entries that have already won the same prize are excluded. - The draw is instant — the winner appears in the winners list immediately. You can draw multiple winners by repeating the process, up to the prize quantity. Manual Selection If your contest uses the manual selection method: 1. Go to the Winners tab. 2. Select which prize to assign from the dropdown. 3. Browse or search the eligible entries list. 4. Click Select next to the entry you want to make a winner. Managing Winners Once winners are selected, you can: Mark as notified After you've contacted the winner (by email, phone, etc.), click Mark notified to record the notification date. This helps you track which winners you've already reached out to. Mark as claimed Once the winner has claimed or received their prize, mark them as claimed. This keeps your records organized. Add notes You can add notes to any winner record — useful for tracking shipping details, communication history, or special arrangements. Remove winner If you need to remove a winner (e.g., they didn't respond, they're ineligible), click Remove. This frees up a prize slot and makes their entry eligible for future draws. Winner Workflow A typical winner management flow: 1. Draw or select winners after the contest ends 2. Contact winners via email or phone 3. Mark as notified to track outreach 4. Fulfill the prize (ship product, send gift card, etc.) 5. Mark as claimed once the winner has received their prize Important Notes - An entry cannot win the same prize twice. - You can select winners at any time — even while the contest is still active. - Removing a winner does not delete their entry; it only removes the winner assignment. - Winner selection data includes: selected date, notified date, claimed date, and the selection method used (random or manual).

📣 Sharing & Distribution

Popup Block

The contest popup is a theme block that displays your contest in a modal overlay on your storefront. It's a great way to capture entries from visitors who are already browsing your store. Adding the Popup to Your Theme 1. In your Shopify admin, go to Online Store > Themes. 2. Click Customize on your active theme. 3. In the theme editor, look for the App embeds section (usually in the left sidebar under the paintbrush icon). 4. Find Contest Popup and toggle it on. 5. Select which contest to display using the contest picker. 6. Configure the settings (see below). 7. Click Save. Contest Selection Use the Contest metaobject picker (app-owned) to choose which active contest the popup should display. Only active contests appear in the picker. If no contest is selected, the popup won't render. If this block was configured before app-owned metaobject migration, the Contest (Legacy) picker remains available and will continue to work. Trigger Settings Control when the popup appears: Trigger type: - Time delay (default) — Popup appears after a set number of seconds. Configure the delay from 1 to 60 seconds (default: 5 seconds). - Scroll percentage — Popup appears when the visitor scrolls to a certain point on the page. Set from 10% to 100% (default: 50%). - Exit intent — Popup appears when the visitor moves their cursor toward the browser's close/back button, signaling they may leave. Frequency Settings Control how often the popup appears to the same visitor: - Once per visitor — Shows once, then never again (uses local storage). - Once per session (default) — Shows once per browser session. - Once per day — Shows once every 24 hours. - Always — Shows on every qualifying page load. Remember when dismissed: When enabled (default: on), if a visitor closes the popup, it won't show again regardless of the frequency setting. Page Targeting Choose which pages show the popup: - Show on all pages (default: on) — Popup can appear on any page. Or target specific page types: - Homepage (default: on) - Product pages (default: on) - Collection pages (default: on) - Cart page (default: off) When "Show on all pages" is disabled, only the individually checked page types will show the popup. Display Options Toggle what content appears in the popup: - Show contest title (default: on) - Show description (default: on) Prizes, dates, terms visibility, button text, and success message are controlled from the contest's Design tab. Style Settings Popup colors, CTA text, and success message are inherited from the contest's Design tab. Popup-specific style options: - Popup style — Choose between Centered modal (default full-screen overlay) and Bottom-right slide-in (less intrusive desktop card) - Overlay color — The dimmed background behind the popup - Popup width — 300px to 600px (default: 450px) - Border radius — 0px to 24px (default: 8px) — controls how rounded the popup corners are

✨ Bonus Entry Actions

Social, Question, Upload, and Secret Code Actions

UserLoop Contests includes several bonus action types for engagement beyond referrals. These actions are configured from the contest Actions tab and are available on the Pro plan. Social Follow Actions Social follow actions help direct entrants to your social profiles. Supported social actions: - Follow on Instagram - Follow on TikTok - Follow on X/Twitter - Subscribe on YouTube Each social action needs a profile or channel URL. You can also customize the action title, description, and entry value. These actions prompt the entrant to visit your profile. Platforms may not always allow apps to verify a follow automatically, so use clear wording and contest terms that match how you plan to validate entries. Visit URL Use Visit URL when you want entrants to view a product, landing page, collection, blog post, or external page. Required field: - URL Good uses: - Send entrants to a new product page. - Ask entrants to review a launch page. - Encourage visitors to read rules or campaign details. Answer Question Use Answer Question to collect lightweight feedback, run a trivia-style contest, or ask entrants to choose an option. Question modes include: - Text answer - Single choice - Multiple choice Choice-based questions need answer options before they appear on the storefront. You can also configure whether a correct answer is required. Photo Upload Use Photo Upload for UGC contests, review campaigns, styling challenges, before-and-after submissions, and unboxing campaigns. Default settings support common image formats including JPEG, PNG, and WebP, with a maximum file size of 10 MB. Make sure your contest terms explain what rights you need for submitted images and how winners will be chosen. Secret Code Use Secret Code when entrants need a code to complete an action. Good uses: - In-package inserts - Retail event giveaways - VIP customer campaigns - Social live stream promotions Settings include: - Code - Case sensitivity - Optional hint Testing Actions Before promoting the contest: 1. Save the actions. 2. Preview the contest page. 3. Complete the entry flow yourself. 4. Confirm the expected entry counts appear on the Entries tab.

📣 Sharing & Distribution

Form Block

The contest form block lets you embed a contest entry form directly into any page of your Shopify theme as an inline section. Unlike the popup, the form sits within the page content — no modal overlay. Adding the Form Block 1. In your Shopify admin, go to Online Store > Themes. 2. Click Customize on your active theme. 3. Navigate to the page where you want the form (e.g., homepage, a custom page). 4. Click Add section or Add block and look for Contest Form. 5. Select which contest to display using the contest picker. 6. Configure the settings (see below). 7. Click Save. Contest Selection Use the Contest metaobject picker (app-owned) to choose which active contest the form should display. Only active contests appear in the picker. If no contest is selected, an empty placeholder state is shown in the theme editor. If this block was configured before app-owned metaobject migration, the Contest (Legacy) picker remains available and will continue to work. Layout Options Choose how the form is arranged: - Vertical (default) — Title, description, prizes, and form fields stack top-to-bottom. Best for narrow columns or sidebars. - Horizontal — Content and form fields sit side by side. Best for wider sections. - Compact — A minimal layout with just the essential form fields. Best when space is limited. Max Width Control the maximum width of the form block: 300px to 800px (default: 500px). The form is centered within its container. Display Options Toggle what content appears in the form: - Show contest title (default: on) - Show description (default: on) - Show prizes (default: on) - Show contest dates (default: off) - Show terms link (default: on) Style Settings Use contest colors (default: on) When enabled, the form uses the colors you configured on the contest's Design tab. When disabled, you can set custom colors per-block: - Button color — The submit button color - Background color — The form background - Text color — All text in the form Additional text options: - Button text — Custom CTA text (default: "Enter to Win") - Success message — Custom text shown after entry (default: "You're entered! Good luck!") Where to Use It The form block works well on: - Homepage — As a section to highlight your current giveaway - Product pages — Alongside products related to the prize - Landing pages — Custom pages dedicated to your contest - Blog posts — Within content announcing the giveaway Form Block vs. Popup | Feature | Form Block | Popup | |---|---|---| | Display type | Inline, part of page content | Modal overlay | | Trigger | Always visible | Time delay, scroll, or exit intent | | Best for | Dedicated sections, landing pages | Passive capture across the site | | Layout options | Vertical, horizontal, compact | Fixed popup layout | | Width control | 300–800px | 300–600px | | Frequency control | N/A (always visible) | Per session/day/visitor | You can use both the form block and popup on the same store — they work independently.

✨ Bonus Entry Actions

Bonus Entry Actions

Bonus entry actions let entrants earn extra entries by completing tasks beyond the base email entry. They are useful for social growth, referrals, product education, UGC collection, and gated campaigns. Bonus actions are available on the Pro plan. Opening the Actions Tab 1. Open a contest. 2. Click the Actions tab. 3. Click Add bonus action. 4. Choose the action type. 5. Configure the required fields. 6. Click Save actions. Email signup is always included as the base entry method. Bonus actions sit underneath that base entry flow. Available Action Types | Action | Use it for | |---|---| | Email Signup | Collect or confirm an entrant email address | | Photo Upload | Ask entrants to upload a photo | | Visit URL | Send entrants to a product, landing page, or external link | | Answer Question | Ask a text, single-choice, or multiple-choice question | | Follow on Instagram | Reward an Instagram profile visit or follow prompt | | Follow on TikTok | Reward a TikTok profile visit or follow prompt | | Follow on X/Twitter | Reward an X/Twitter profile visit or follow prompt | | Subscribe on YouTube | Reward a YouTube channel visit or subscribe prompt | | Referral Share | Reward entrants when friends enter through their referral link | | Secret Code | Require entrants to enter a code before receiving entries | Entry Values Each action has an entries value. This is the number of extra entries awarded when the action is completed. Keep values proportional to the effort required. Examples: - Follow a social profile: 1-3 entries - Visit a product page: 1 entry - Upload a photo: 5-10 entries - Refer a friend: 1-3 entries per referred entrant Required Actions You can mark an action as required. Required actions must be completed before the entrant can finish the contest flow. Use required actions carefully. They can improve entry quality, but they can also reduce conversion if the action feels too demanding. Incomplete Actions Some actions need specific configuration before they appear on the storefront: - Visit URL needs a URL. - Social follow actions need a profile URL. - YouTube subscribe needs a channel URL. - Answer Question needs a question, and choice-based questions need answer options. - Secret Code needs a code. Incomplete actions are not shown to customers. Best Practices - Keep the number of actions small. Two or three strong actions usually perform better than a long checklist. - Match actions to your campaign goal. - Use clear action titles so entrants understand what to do. - Test the storefront entry flow before promoting the contest.

🛠️ Contest Setup

Contest Lifecycle

Every contest moves through a series of statuses. Understanding these helps you manage your contests effectively. Statuses Draft When you create a contest, it starts in Draft status. - The contest is not visible to customers - The contest page URL returns a "not found" page - You can freely edit all fields - Theme blocks won't display draft contests Actions available: Activate, Edit, Delete Active Activating a contest makes it live and available to customers. - The contest page is publicly accessible at its URL - The entry form accepts submissions - Theme blocks (popup and form) can display the contest - The contest is synced to Shopify metaobjects so your theme can access it - Analytics tracking begins (page views, entries) Actions available: End contest, Preview, Copy link, Archive Ended A contest ends when you manually end it or when the end date passes. - The contest page is no longer accepting entries - Existing entries are preserved - You can still view entries and select winners - Theme blocks stop displaying the contest - The contest metaobject is kept in Shopify in draft mode so existing block selections stay connected Actions available: Archive, View entries, Select winners Archived Archiving a contest removes it from your active view. - Hidden from the contest list by default (use the filter to see archived contests) - Not available in theme blocks - Metaobject remains in Shopify in draft mode to preserve existing block references - All data (entries, winners) is preserved Actions available: View entries, View winners Changing Status Activating a Contest 1. Open the contest you want to activate. 2. Click the Activate button. 3. The contest immediately goes live. Before activating, make sure your title, description, prizes, and entry settings are configured — some fields lock after activation. Ending a Contest You can end a contest in two ways: - Manually — Click the End contest button on any active contest. - Automatically — The contest stops accepting entries when the end date passes. The status updates the next time the contest is accessed. Archiving a Contest Click Archive from the contest actions menu. This works from any status (draft, active, or ended). Status Flow Draft → Active → Ended → Archived ↓ ↑ └────────────────────────┘ (can archive directly) Duplicating a Contest You can duplicate any contest to create a copy with the same settings: 1. Go to the Contests list. 2. Find the contest you want to copy. 3. Click Duplicate from the actions menu. The duplicate is created in Draft status with a new slug (the original slug with a timestamp suffix to ensure uniqueness). All settings, prizes, and display configurations are copied — entries and winners are not.

How can we help?

Getting Started

Contest Setup

Design & Customization

Sharing & Distribution

Bonus Entry Actions

Entries & Winners

Integrations

Billing & Plans

FAQ & Troubleshooting

Selecting Winners

Popup Block

Social, Question, Upload, and Secret Code Actions

Form Block

Bonus Entry Actions

Contest Lifecycle