All Docs

What is a Contest Box?

KickoffLabs Contest Boxes allow you setup viral contests on your site in minutes.

They support every KickoffLabs campaign type and can be customized to include campaign actions, rewards, leaderboards, and customer referral mechanics.

Our Contest Box embed feature allows for you to directly embed the Contest Box onto a page of any website! (aslong as you have access to add HTML to your website). Leads can easily opt-in to the contest via the embedded form and view their stats/share with friends.

If you’d like to instead install Contest Box as a widget that pops up in the bottom corner of your website, we still offer that option!

Below we’ll walk you through, step by step, embedding the Contest Box on your external website! If you haven’t already, start off by customizing your contest box. 

Embedding Contest Box

1. From the campaign dashboard, click to edit your Contest Box
2. Next, select the installation tab and scroll down to “Embedding on Your Non-KickoffLabs Site.”
3. Copy the provided HTML script and paste the HTML on your website where you’d like the Contest Box to render

Important Notes

Some things to keep in mind while installing the embeddable Contest Box:

1. At this time we only support one embedded contest box installed on a page at a time.
2. If you have the embedded contest box on a page the pop-up box will no longer render.
3. The embedded Contest Box will always show where you have the HTML installed on your website until you remove the script.
4. The Contest Box will fill full-width wherever it’s installed.

Customizing the Embed Script

There are two options in the settings of the HTML. “embedHeight” supports either “full” or “custom”.

Full: will make the embed always have the full height of the contest box.

Custom: will use the second property embedHeightPixels to determine a fixed height with a scroll bar.

If you have any questions, or need help, please send us an email at: support@kickofflabs.com