WooCommerce Setup

Learn how to setup the WooCommerce Purchases promotion.

Giancarlo Massaro avatar
Written by Giancarlo Massaro
Updated over a week ago

Our purchases app allows you to install our widget on your order confirmation page and user account page allowing users to see how many entries they've earned for their purchase.

Already have your promotion setup and need to install it? Skip to Step 10.


  • You must be using WooCommerce.

  • Your products and variants should have unique SKUs.

Step 1.

Create a new promotion in ViralSweep and choose Purchases > WooCommerce.

Step 2.

If your store is connected, you will see it at the top. If it is not, please connect it.

To connect your store, login to WooCommerce.

To obtain your store URL, go to:

  • Wordpress Settings > General > Site Address (URL)

To obtain your Consumer Key and Secret Key go to:

  • WooCommerce Settings > Advanced

  • Click the REST API link and click Add Key.

  • Type in ViralSweep for the description. Choose your user, then permissions should be set to Read/Write. Click Generate API Key.

  • A consumer key and secret key will be generated. Copy both of them and paste them into ViralSweep to connect your store.

Once your store is connected, it will show up like this in ViralSweep:

Step 3.

Once connected, decide if every product in your store will qualify for the sweepstakes (this is the default) or if only specific products will qualify. If only specific products will qualify, then click Update Products and choose Import Products and All Variants.

All of your products and variants will now be pulled in and will appear on the right side.

Step 4.

Choose the products/variants that apply for this particular promotion by selecting them. If someone purchases a product or variant that is not selected, then their order will not qualify to earn any entries into the sweepstakes.

Step 5.

  • Insert a title for your promotion.

  • Choose start and end dates.

  • Indicate how many winners.

  • Leave Raffle Tickets Enabled set to NO (raffle tickets are to be used for non profits only)

  • Input your Store URL.

Step 6.

Within the entries section, the default is 1 entry for every $1 spent, but you can change this to whatever you would like. You can change currency in the top right corner. You can also schedule bonus periods if you want to change the number of entries being awarded on specific dates.

The non-qualifying order section would only appear if a user purchases something that did not qualify for the sweepstakes. Our widget would let them know at checkout that their order did not qualify.

Step 7.

If you want to award a bonus on orders over a certain dollar value, you can add this in the order bonus section. This feature helps to increase average order value.

Step 8.

If you want to allow people to earn bonus entries into the sweepstakes for completing actions after they make a purchase, you can add these in the social actions section.

Step 9.

  • Upload any images you want appearing on the widget that users see after their purchase.

  • Insert your official rules.

  • In the design section you can change the styles on our widget.

  • You can setup email notifications to send people how many entries they have when they make a purchase.

  • When you're all set, save the promotion by clicking the green Done button.

Step 10.

We offer free installation to your store, so if you need help with installation, please contact us and invite [email protected] with editor access to your store.

To install the promotion on your store, go to the Install tab in your ViralSweep dashboard and click Install Widget. Copy the code under 1. Install to Checkout.

Step 11.

Login to Wordpress and go to:

Tools > Plugin File Editor

In the top right under Select plugin to edit, choose WooCommerce and click Select.

Step 12.

In the file list on the right side find:

templates > checkout > thankyou.php

Step 13.

You may need to play around with pasting our code into different sections depending upon where on the order completion screen you want the widget appearing. For us, we think it is best to install it below the "Thank you. Your order has been received message".

Paste our code directly below this section, as shown in the screenshot below.

Step 14.

Go back to ViralSweep, go to the Install tab and copy the code under Step 2: Install to Theme.

Step 15.

Login to Wordpress and go to:

Tools > Theme File Editor

Select the theme to edit, then click on:

Parts > Footer.html

Paste in the code at the top of the file and save it.

Step 16.

If your store has user accounts and you want people to see their entries when they login to their account, continue on. Otherwise, skip to Step 18.

In your ViralSweep dashboard copy the code under Step 3: Install to Account Page.

Step 17.

Login to Wordpress and go to:

Tools > Plugin File Editor

In the top right under Select plugin to edit, choose WooCommerce and click Select.

In the file list on the right side find:

templates > myaccount > dashboard.php

In the dashboard.php file, find the section that has the "Hello" message. Paste the code directly below this section, as shown in the screenshot below.

Step 18.

You're done! Make a purchase on your store and you'll see the widget appear on your order confirmation page, and it will display the correct amount of entries you've earned for making that purchase. If you installed our code to user accounts, you can also login to the user account you purchased with to see your entries there too.

Widget example embedded in the store checkout:

Legal Disclaimer

ViralSweep provides this feature to allow you to run purchase based sweepstakes and raffles on your store. However, most states and countries have variations in their laws and regulations regarding purchases when it comes to sweepstakes and raffles. ViralSweep assumes no responsibility for whether you are in compliance with the law. You understand that it is your responsibility to ensure that your official rules comply with the rules and regulations of your locality, including offering a free alternate method of entry where applicable.

If you are interested in having ViralSweep handle legal compliance for your promotion within the United States and Canada, please contact us.

We're here to help

If you have any further questions, please start a Chat. Just "Click" on the chat icon in the lower right corner to talk with our support team.

Did this answer your question?