Add a form to your theme
Place a form in the theme editor, set the handle, and enable reCAPTCHA when needed.
Use this when the form is ready and you want it live on the storefront.
Before you start
Have these ready first:
the form has been created in Forms
the form handle is confirmed in Settings
your theme supports app blocks or app sections where you want the form to appear
a reCAPTCHA v2 Invisible site key is ready if spam protection will be enabled
Add the form block
Add the reCAPTCHA site key if needed
If the form uses spam protection, add your reCAPTCHA Site Key in the block settings.
The matching secret key must also exist in the app settings.
Use Enable reCAPTCHA spam protection for the full key setup.
Block settings you will use most
Roadmap Form Handle
This tells the theme block which form to render.
If the wrong handle is used, the storefront form will not match the form you built.
reCAPTCHA Site Key
Use this only when Enable reCAPTCHA spam protection is turned on for the form.
The site key is the public key used by the storefront block.
Placement tips
Use a dedicated page template for long forms.
Use a narrower section for short contact or lead forms.
Keep enough spacing around the form so validation messages stay readable.
Test on mobile after saving.
Troubleshooting
The block shows no preview
Check the form handle first.
If the handle is correct, save the theme and test on the storefront.
reCAPTCHA is enabled but the form still fails
Check these first:
the form toggle is enabled in Settings
the theme block has the site key
the app settings have the matching secret key
The wrong form appears
Check that the handle in the theme block matches the handle in the form settings exactly.
Related guides
Last updated