Getting Started
Install, pick a plan, and get the widget live on your storefront.
- Install Lucky You
- Choose a Plan
- Enable Theme App Embed
- Pick Setup Mode
- Publish Your Setup
Back to home
Help
Setup guides, reference for rewards, impressions and billing, and fixes for the things that go wrong most often.
Categories
Configuration Wizard
Define how the game behaves — type, rewards, rules and design.
- Quick Setup
- Guided Setup
- Choose Game
- Switching Game Type
- Rewards Setup
- Reward Probability
- Design Settings
- Rules & Eligibility
- Review & Publish
Storefront Experience
What your visitors see, from launcher to prize claim.
- Storefront Widget
- Popup Launcher
- Game Modal
- Prize Claim Flow
- Decline Prize
- No-Reward Result
- Customer Cooldown
- Hide During Cooldown
Rewards & Codes
How discount codes are generated, assigned, refilled and repaired.
- Reward Types & Values
- Reward Inventory / Codes
- Claim vs Redemption
- Reward Refill
- Reward Health / Repair
- Redemption Tracking
Email & Leads
Capture, verification, and getting leads out of the app.
- Email Capture
- Marketing Opt-In
- OTP Verification
- OTP Resend
- Previously Verified Email
- Same-Email Cooldown
- Leads Page
- Lead Stats
- CSV Export
- Export Dedupe
Impressions & Usage
What counts, what your limit is, and what happens at the ceiling.
- What Counts as an Impression
- Monthly Impression Limit
- Effective Capacity
- Capacity Warnings
- Capacity Blocking
- Monthly Reset
- Bonus Impressions
- Purchased Add-Ons
Billing & Plans
Plan changes, billing cycles, and how they differ from usage cycles.
- Plan Selection
- Monthly Billing
- Annual Billing
- Upgrade Plan
- Downgrade Plan
- Cancel / Free Plan
- Current vs Pending Plan
- Renewal vs Impression Reset
Auto-Upgrade
Let capacity scale itself — with your approval in Shopify.
- Manual vs Automatic Mode
- Auto-Upgrade
- Upgrade Threshold
- Max Plan Limit
- Pending Approval
Dashboard
Status, configuration health, and what needs your attention.
- Overview
- Global Status & Issues
- Configuration Health
- Reward Availability
- Billing & Usage Card
- Auto-Upgrade Status
- Performance Insights
Analytics
Conversion, claims, funnel and attributed revenue.
- Analytics Page
- Time Ranges
- KPI Metrics
- Conversion Rate
- Claim Rate
- Funnel View
- Charts
- Revenue Analytics
Troubleshooting
The things that go wrong most often, and what actually fixes them.
- Widget Not Showing
- Cannot Play
- Cooldown Modal
- Resume Claim Flow
- Cannot Claim Reward
- Reward Not Redeemed
- No Codes Available
- OTP Not Arriving
- Email Blocked
- Duplicate Leads
- Billing Not Updated
- Annual vs Monthly Reset
- Add-On Expired
- Auto-Upgrade Not Triggered
- Revenue Missing
Start here
Getting Started
Five steps from installing the app to a live widget on your storefront.
- 1
Install Lucky You
Installs Lucky You into your Shopify store and connects it to your admin so you can configure and manage your campaigns.
How it works
- The app only works inside Shopify Admin
- You must be logged into the correct store
- Access depends on your Shopify session
Common issues
“App keeps redirecting”
Your Shopify session expired — log in again.
“App not opening”
Make sure you installed it on the correct store.
- 2
Choose a Plan
A plan defines how many times Lucky You can be shown to visitors (impressions) during each usage cycle.
How it works
- Each plan includes a monthly impression limit
- Impressions are consumed when visitors see or open the widget
- Usage resets roughly every 30 days (impression cycle)
- Annual billing is cheaper, but impressions still reset monthly
- Plan controls capacity, not just pricing
- Changes require Shopify approval before taking effect
Common issues
“Plan changed but app still shows the old one”
Shopify approval or sync may take a short time.
“Annual plan but impressions reset monthly”
This is expected behaviour — billing and impression cycles are separate systems.
- 3
Enable Theme App Embed
This controls whether Lucky You is allowed to appear on your storefront.
How it works
- The embed must be enabled inside your Shopify theme
- Changes must be saved in the theme editor
- This is separate from publishing your setup inside the app
- This is the single most common reason the widget does not show
- Toggling the embed off hides the widget immediately
Common issues
“Everything is set up but the widget isn't showing”
The theme app embed is not enabled.
“App stopped showing”
The theme changed, or the embed was disabled.
- 4
Pick Setup Mode
Determines how your game configuration is created — automatically or manually.
How it works
- Quick Setup generates a ready-to-use configuration instantly
- Guided Setup lets you configure every part manually
- Both modes produce the same final system
- Use Quick Setup for a fast launch or testing; Guided for full control
- Re-applying Quick Setup can overwrite your configuration
Common issues
“My setup changed after switching mode”
Quick Setup regenerated the configuration. Review your setup after switching.
- 5
Publish Your Setup
Publishing makes your configuration active and allows it to run on your storefront.
How it works
- Your setup exists as a draft until you publish it
- Publishing activates the configuration and prepares rewards
- Publishing alone is not enough — the setup must be published, the theme app embed enabled, and impression capacity available
- Rewards may take a short time to become ready after publishing
Common issues
“I published but nothing shows”
Check the theme app embed and your impression capacity.
“Changes not visible”
The setup was not re-published.
Still stuck?
The full documentation for every category above lives inside the app, under Help. For anything else, email us — we read every message.