Step 1: Get Your Google reCAPTCHA Site Key
Before you can use the plugin, you’ll need a Site Key from Google reCAPTCHA.
Visit the Google reCAPTCHA website.
Log in with your Google account.
Register your site by clicking + Add in the reCAPTCHA Admin Console.
Choose reCAPTCHA v2 and select the option “I’m not a robot” Checkbox.
Enter the domain name of your Bubble app (e.g.,
your-app-name.bubbleapps.io).Accept the reCAPTCHA Terms of Service.
Click Submit.
Copy the Site Key from the provided keys in the Google reCAPTCHA dashboard.
Step 2: Add the Site Key to Your Bubble App
Now that you have your Google reCAPTCHA Site Key, add it to the plugin settings in Bubble.
In your Bubble app editor, navigate to Plugins> reCAPTCHA > Site Key.
Paste the Site Key you copied from Google reCAPTCHA.
Step 3: Add the reCAPTCHA Element to Your Page
After configuring the plugin, you can add the reCAPTCHA element to any page in your app where you want to verify users.
In your Bubble Editor, open the page where you want to place the reCAPTCHA.
From the Elements tab, select Plugins and choose the reCAPTCHA v2 element.
Drag and drop the reCAPTCHA element onto your page (e.g., a login or sign-up form).
Customize the size and position of the element as needed.
Step 4: Customize the reCAPTCHA Theme
You can adjust the appearance of the reCAPTCHA widget to fit your app's design.
Select the reCAPTCHA element on your page.
In the properties panel, you will see options to change the theme:
Light Theme: The standard white background with a grey border.
Dark Theme: A black background with a white border for darker page designs.
Choose the theme that matches your app's style.
Step 5: Going Live
Once you've tested the reCAPTCHA widget in your development environment, make sure you:
Add your live domain (e.g.,
www.your-app.com) to the list of authorized domains in the Google reCAPTCHA Admin Console.Deploy your Bubble app to live mode.
Troubleshooting Tips
Missing Site Key: Ensure you’ve copied the correct Site Key from the Google reCAPTCHA dashboard and pasted it into the API Keys section of your app's settings.
Widget Not Displaying: Confirm that the domain in your Google reCAPTCHA settings matches your app’s domain. Double-check the theme settings in the properties panel.
reCAPTCHA Failing Verification: Ensure that reCAPTCHA is properly configured and that the user is successfully completing the CAPTCHA challenge.