Requirements
Before you begin, make sure:
You’re using BigCommerce
Your products and variants have unique SKUs (recommended for accuracy)
You are not using a legacy Blueprint theme
→ If you are, please contact support for assistance
Step 1: Create a Promotion
Create a new promotion
Select Purchases → BigCommerce
Step 2: Connect Your Store & Import Products
If your store is already connected, it will appear at the top
If not, connect your store before continuing
Next, choose how products will qualify:
All products qualify (default)
Only specific products qualify
If selecting specific products:
Click Update Products
Select "Yes Proceed"
Your products and variants will appear on the right-hand side once imported.
Step 3: Select Eligible Products
Choose which products or variants qualify for the promotion.
Only selected items will earn entries
Orders containing non-selected items will not qualify
Step 4: Configure Promotion Details
Fill out the following:
Promotion title
Start and end dates
Number of winners
Store URL
Important:
Set Raffle Tickets Enabled = NO
(Raffle tickets are intended for nonprofit use only)
Step 5: Set Entry Rules
By default, customers earn:
1 entry per $1 spent
You can customize this by:
Adjusting the entry rate
Changing currency (top right corner)
Scheduling bonus periods with increased entry values
Adding bonus entries for orders over a certain amount
Note:
If a purchase does not qualify, the widget will inform the customer on the confirmation page.
Step 6: Add Bonus Actions (Optional)
You can reward customers with additional entries for completing actions after purchase (e.g., social sharing).
Configure these in the Social Actions section.
Step 7: Customize the Experience
Before saving your promotion:
Upload images for the post-purchase widget
Add your official rules
Customize widget design in the Design section
Enable email notifications to send customers their entry totals
Once complete, click the green Done button to save.
Step 8: Install the Promotion
If you’d like help, we offer free installation support—just contact us.
To install manually:
Go to the Install tab in your dashboard
Choose Widget or Lightbox
Copy the code under Step 1: Install to Checkout
Step 9: Add Code to Checkout
In your BigCommerce store:
Go to
Settings → Data Solutions (formerly Web Analytics) → Affiliate Conversion TrackingPaste the code
Click Save
Step 10: Add Code to Your Theme
In ViralSweep, copy code from Step 2: Install to Theme
In BigCommerce, go to:
Storefront → Script Manager → Create a Script
Configure:
Name: ViralSweep
Location: Head
Pages: All pages
Category: Essential
Type: Script
Paste the code and click Save
Step 11: (Optional) Add to Customer Accounts
If your store uses customer accounts and you want users to view entries after logging in:
Copy code from Step 3: Install to Account Page
In BigCommerce, go to:
Storefront → Advanced → Edit Theme Files → Templates → Pages → Account → Orders → All.htmlPaste the code before the closing
</main>tagSave changes
If you don’t need this feature, skip to Step 12.
Step 12: Test Your Setup
You’re all set! 🎉
To confirm everything is working:
Make a test purchase
View the order confirmation page
You should see:
The widget displaying entries earned
Or raffle ticket numbers (if enabled)
If installed for accounts, users can also log in to view their entries.
Legal Disclaimer
ViralSweep provides tools for running purchase-based sweepstakes and raffles.
However, laws vary by location.
ViralSweep does not guarantee legal compliance
You are responsible for ensuring your promotion follows applicable laws
This may include offering a free alternate method of entry
Need help with compliance in the U.S. or Canada? Contact us for assistance.
Need Help?
If you have questions, we’re here for you.
Start a chat by clicking the icon in the bottom-right corner of your screen to connect with our support team.