Description
Contests by Rewards Fuel lets you run giveaways on your WordPress site without building a contest engine yourself. You create the campaign in the Rewards Fuel dashboard, then this plugin embeds it on any post or page.
Use it for giveaways, sweepstakes, and referral campaigns. The same contest can live on a hosted page and on your WordPress site.
What this plugin does
- Connect your site with an API key from Account > WordPress Integration in the Rewards Fuel dashboard
- View your contests inside WordPress admin > Rewards Fuel
- Copy a shortcode or use the Rewards Fuel Contest Gutenberg block
- Embed the contest widget on posts, pages, and most themes
- Open the dashboard to edit contests, view stats, and pick winners
- Run a documented random draw with Winner Picker (powered by RFWIN)
What you build in Rewards Fuel (not inside WordPress)
- Contest schedule, rules, prizes, and appearance
- Entry methods (social actions, newsletter signup, questions, referrals, and more, by plan)
- Hosted contest page at
r-f.page, or an embed on your own site - Statistics, CSV export, winner selection, and prize claim flow
Popular entry methods
Available entry methods depend on your plan. Examples include:
- Click to enter – simple one-click entry
- Newsletter signup – collect email addresses (with optional confirmation for newsletter entries)
- Refer a friend – bonus entries when friends enter via a share link
- Answer a question – collect feedback or quiz answers
- Visit a URL – drive traffic to a landing page
- Code word – entrants enter a secret phrase
- Social actions – link-based entry methods for major social networks (availability varies by plan)
- Email list member – allow pre-approved emails on your contest list to enter
- File upload – photo or document submissions
Platform features (dashboard)
- Physical and digital prizes – upload digital prize files; winners claim online
- Geo restrictions – block selected countries from entering
- Bot protection – optional Cloudflare Turnstile per contest
- Custom appearance – colors, fonts, backgrounds, and widget wording
- 11 widget languages – English, Spanish, French, German, Portuguese, Italian, Dutch, Polish, Japanese, Korean, and Simplified Chinese
- Contest statistics – entries, methods, countries, traffic, referrers, device breakdown, and entrant summaries
- CSV export – download confirmed entrants from the dashboard
- Winner tools – random or manual winner selection; optional auto-pick and winner notification emails when the contest ends
- Scheduled draws – weekly, daily, or end-of-contest prize draws while live
- Copy a contest – duplicate setup for your next campaign
- Webhooks (paid plans) – send new entry or winner events to automation tools such as Make or Zapier from the Rewards Fuel dashboard, not from this plugin
Embed on WordPress
After connecting your API key, embed any contest with:
[rewardsfuel id="YOUR_CONTEST_REF"]
Legacy shortcodes still work:
[rf_contest id="123"]
Or add the Rewards Fuel Contest block in the block editor.
Pricing
Rewards Fuel has a free plan with unlimited contests and entries, plus paid plans with more entry methods and statistics. No credit card is required to start. See current pricing at rewardsfuel.com/pricing.
Get started
- Create a free account
- Create a contest in the Rewards Fuel dashboard
- Generate an API key under Account > WordPress Integration
- In WordPress: Rewards Fuel > Your account, then paste your key
- Copy the shortcode from Rewards Fuel > Contests into any post or page
Questions? Email info@rewardsfuel.com.
Translations
Widget copy supports 11 languages (configured per contest in the dashboard). The WordPress plugin admin UI is English.
Installation
- Upload the plugin folder to
/wp-content/plugins/or install from the WordPress.org plugin directory - Activate Contests by Rewards Fuel under Plugins
- Go to Rewards Fuel > Your account and paste your API key from the Rewards Fuel dashboard
- Open Rewards Fuel > Contests, copy a shortcode, and paste it into a post or page
FAQ
Do I create contests inside WordPress?
No. Contests are created and managed at app.rewardsfuel.com. This plugin lists your contests and embeds them on your site.
How do I connect my account?
Sign in to Rewards Fuel, open Account > WordPress Integration, generate an API key, then paste it on Rewards Fuel > Your account in WordPress.
How do I embed a contest?
Use the shortcode shown in the plugin contest list, for example [rewardsfuel id="2BB52"], or insert the Rewards Fuel Contest block and choose a contest.
Does the plugin sync entries to Mailchimp, Klaviyo, or other email tools?
No. The WordPress plugin does not export or sync entrants to third-party email providers. You can collect emails with a newsletter entry method and export entrants to CSV from the Rewards Fuel dashboard. Paid Rewards Fuel plans can also send entry and winner events to automation tools such as Make or Zapier from the dashboard.
Can I export my contestants?
Yes. From the Rewards Fuel dashboard Stats tab for each contest (CSV download). That export is not built into the WordPress admin screens.
What statistics are available?
In the dashboard: total and unique entries, entries by method, top countries, traffic and referrers, device breakdown, live entry feed, entrant summaries, and winner history. Depth of stats views depends on your plan.
Are social entries verified automatically?
Most social entry methods use trackable links or on-page actions. They encourage the desired action but are not the same as deep API verification for every network. Like and follow actions have limited verification industry-wide.
Are you affiliated with social networks mentioned in entry methods?
No. Names of social networks describe optional entry methods you configure in the Rewards Fuel dashboard. Rewards Fuel is not affiliated with, sponsored by, or endorsed by those companies.
Can I run the contest on a hosted page instead of WordPress?
Yes. Every contest has a hosted URL at r-f.page in addition to the embed shortcode.
What does this cost?
There is a free plan with unlimited contests and entries. Paid plans add more entry methods and statistics. See rewardsfuel.com/pricing.
What data does the plugin send to Rewards Fuel?
When you activate the plugin, it may send your site URL, a hash of that URL, and the plugin and WordPress versions so Rewards Fuel can see that a site installed the plugin. After you connect with an API key, the plugin may also send PHP version, theme name, locale, how many posts use a Rewards Fuel embed, contest counts, and a weekly heartbeat so Rewards Fuel can support the install. No visitor or entrant data is sent from WordPress. See rewardsfuel.com/privacy.
What is removed if I uninstall the plugin?
Uninstalling deletes the saved API key and related plugin options from WordPress, and unschedules the weekly heartbeat. It does not delete contests or entrants in your Rewards Fuel account.
Something we missed?
Email us at info@rewardsfuel.com.
Screenshots





Changelog
3.3.0
- Renamed listing to Giveaways & Contests by Rewards Fuel.
3.2.9
- Fold in unpublished 3.2.7 and 3.2.8 work, plus security, compatibility, and listing updates
- Security and compatibility: escape contest names in admin lists, use
$wpdb->preparefor embed counts, exit after the welcome redirect, and remove a localhost branch from Winner Picker - Bundle popper.js and stop loading Google Fonts or cdnjs from the admin screens (wordpress.org guideline)
- Use the plugin’s own logo and loader instead of a CDN spinner
- Remove unused legacy admin views (including a leftover editor that printed the API key)
- Uninstall now deletes the saved API key, onboarding options, and the weekly ping
- Gutenberg block
apiVersion3 and ablock.jsonfile - PHP 8.3/8.4: explicit nullable parameter type on API requests
- Install activation ping before account connect (site URL, URL hash, plugin and WordPress versions) and a first-admin-view log after connect
- New wordpress.org screenshots, people banner, and icon; readme polish for WordPress 7.1
3.2.8
- Not shipped on wordpress.org. Listing copy for contest types and dashboard webhook automations (Make, Zapier) is included in 3.2.9
3.2.7
- Not shipped on wordpress.org. Consistent “WordPress Integration” naming, trademark FAQ, and pre-connect install telemetry are included in 3.2.9
3.2.6
- Material-inspired admin UI refresh (cards, chips, pill buttons)
- Fix Gutenberg contest block not appearing on the public site (server-side block registration)
- Unified account connection card; dashboard links include your site URL for API key setup
- Contest list: full-width table, fixed shortcode copy, cleaner Edit/Stats/Visit action group
- Winner Picker admin page shipped in the plugin package
- Block editor and Winner Picker styling aligned with the new admin UI
3.2.1
- Fix critical error on update: register the weekly cron interval before scheduling (3.2.0 used an invalid schedule name)
- Safer plugin activation – telemetry runs on shutdown and cannot white-screen the site
- Fix meta box callback that could trigger “Cannot redeclare function” on some editors
- Harden contest telemetry snapshot parsing
3.2.0
- Site telemetry for the Rewards Fuel platform: plugin/WP/PHP versions, theme, locale, embed post count, contest counts
- Weekly heartbeat (
POST /api/wp/ping) so we know which sites are still active - Sends
disconnectedbefore removing the API key; all API calls include site URL headers for last-seen tracking - Connect and activate events now include a full site snapshot
3.1.2
- Declared compatibility with WordPress 7.0
3.1.1
- Production URLs: dashboard at app.rewardsfuel.com, API at app.rewardsfuel.com/api/wp/
- Plugin-side error logging to Rewards Fuel admin Logs (connect, API failures, deactivation)
- Fixed deactivation hook (no longer calls removed legacy helpers)
3.1.0
- Fixed widget embed markup (
rf-widgetmount div required by the v2 widget) - Encoded contest refs in shortcodes;
[rewardsfuel id="REF"]matches the web dashboard - Updated dashboard and app URLs for the v2 Cloudflare API
- Dynamic Gutenberg block with server-side render
- Legacy embed upgrade path for older saved blocks
- Rewrote plugin readme for accurate v2 features (removed outdated email-provider export claims)
3.0.0
- Complete rewrite for v2 infrastructure: API key auth, new widget URLs, simplified WordPress admin
2.0.66
- Maintenance release for legacy platform
