How do I add Cloudflare Turnstile to my giveaway?
Quick answer
Create a Turnstile widget in your Cloudflare dashboard and add every domain your giveaway runs on, including giveaway.ninja if you use a Direct URL. Paste the Site key and Secret key into Giveaway Ninja and switch on Enable Cloudflare Turnstile. It is free, and most real entrants never see a challenge.
Cloudflare Turnstile stops bots from entering your giveaway without making real entrants solve puzzles. It is free to use and you don't need to move your store to Cloudflare.
1) Create your Turnstile keys in Cloudflare
- Sign in to the Cloudflare dashboard (a free account is enough) and open Turnstile.
- Click Add widget and give it a name, for example "Giveaway".
- Hostnames: add every domain where your giveaway can appear, for example yourstore.myshopify.com and your custom storefront domain. If you use our Direct URL feature, also add giveaway.ninja.
- Widget mode: choose Managed (recommended) or Invisible. With Managed, Cloudflare shows a checkbox only to visitors it is unsure about. With Invisible, nobody ever sees it.
- Click Create and copy your Site key and Secret key.
2) Add the keys in Giveaway Ninja
- Open the Campaign editor and click Edit Giveaway.
- Go to GIVEAWAY and open the Bot Protection section.
- Under Cloudflare Turnstile, switch on Enable Cloudflare Turnstile, then paste your Site key and Secret key.
- Click SAVE.
From now on Giveaway Ninja checks every sign-up and every completed entry action with Cloudflare before it counts. Your Secret key is never sent to the storefront.
Please note: test the giveaway live before you publish it. If you can't enter, there's a problem with the keys or the hostnames. Check your browser's console log for a "Turnstile error" message with the exact code.
What do entrants see?
That depends on the Show the Turnstile box setting under the Turnstile keys:
- Only when needed (recommended): usually nothing. Turnstile runs in the background while the entrant fills in the form. If Cloudflare needs a quick confirmation, a small "Verify you are human" checkbox appears at the bottom of the giveaway window. The entry goes through as soon as it is ticked.
- Always: the Turnstile box is shown in the sign-up form, above the Enter button. Entrants see it verify them, which shows the giveaway is protected.
If your Cloudflare widget uses the Invisible mode, nothing is shown with either setting.
Turnstile is one layer. Combine it with Bot Protection (IP and subnet limits, VPN blocking) and email confirmation. See all of Giveaway Ninja's fraud protection features.
Can I use Turnstile and reCAPTCHA together?
Yes. The two switches are independent and both checks run when both are on. One of them is enough, so most stores pick one. If you are moving from reCAPTCHA to Turnstile, switch Turnstile on, test an entry, then switch reCAPTCHA off. See how to add reCAPTCHA to your giveaway.
Why does Turnstile stop people from entering my giveaway?
- Error 110200 (domain not allowed): the page's domain isn't in the widget's hostnames. Add it in Cloudflare and save. Changes can take a couple of minutes.
- Error 110100 or 110110 (invalid site key): the Site key was pasted incompletely or belongs to a deleted widget. Copy it again from Cloudflare.
- "Security check failed" when entering: the Secret key doesn't match the Site key, or the entrant's page was open for a long time. Check both keys come from the same widget, then reload the page and try again.
- Old browser tab: an entrant who had your store open before you switched Turnstile on is asked to reload the page. After a reload the entry works.
Does Turnstile cost anything?
Turnstile is provided by Cloudflare, not by Giveaway Ninja, and Cloudflare offers it free of charge. Check Cloudflare's Turnstile plans for the current limits on widgets and hostnames.
People also ask
Should I use Turnstile or reCAPTCHA?
Either one stops automated sign-ups. Turnstile is free with no usage tiers and does not show image puzzles. Pick one; running both works but adds nothing. See how to add reCAPTCHA to your giveaway.
Does my store need to use Cloudflare?
No. You only need a free Cloudflare account to create the keys. Your store's DNS and hosting stay as they are, on Shopify, Wix, WooCommerce or anywhere else.
How else can I keep fake entries out of the draw?
Turn on Bot Protection and require email confirmation, then leave "Include users with unconfirmed emails" off when you draw. See how to remove bot entrants.
Still stuck?
Our support team is available 24/7 and always replies. Send us a message and we'll help you sort it out.