{"id":2264,"date":"2025-01-10T13:47:51","date_gmt":"2025-01-10T11:47:51","guid":{"rendered":"https:\/\/plumrocket.com\/learn\/?p=2264"},"modified":"2026-08-19T12:17:50","modified_gmt":"2026-08-19T09:17:50","slug":"how-to-add-google-recaptcha-to-custom-form-in-magento-2","status":"publish","type":"post","link":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha","title":{"rendered":"How to Add Google reCAPTCHA to Custom Form\u200b in Magento 2"},"content":{"rendered":"\n
\"How<\/figure>\n\n\n\n

Google reCAPTCHA helps protect websites from spam, bot attacks, and other automated form submissions.<\/p>\n\n\n\n

Adding reCAPTCHA to your Magento 2 custom forms adds an essential layer of security, ensuring only genuine user interactions are processed by your site.<\/p>\n\n\n\n

Magento 2 already includes a built-in implementation of Google reCAPTCHA for standard frontend forms, such as:<\/p>\n\n\n\n

    \n
  1. Customer Login<\/li>\n\n\n\n
  2. Forgot Password<\/li>\n\n\n\n
  3. Create New Customer Account<\/li>\n\n\n\n
  4. Edit Customer Account<\/li>\n\n\n\n
  5. Contact Us<\/li>\n\n\n\n
  6. Product Review<\/li>\n\n\n\n
  7. Newsletter Subscription<\/li>\n\n\n\n
  8. Send to Friend<\/li>\n\n\n\n
  9. Checkout\/Placing Order<\/li>\n\n\n\n
  10. Coupon Codes, and\u00a0<\/li>\n\n\n\n
  11. PayPal PayflowPro payment.<\/li>\n<\/ol>\n\n\n\n

    Additionally, Magento\u2019s flexibility allows us to add Google reCAPTCHA to custom forms as needed. This guide will walk you through the process of configuring Google reCAPTCHA in Magento 2, creating a custom extension for your form, and integrating reCAPTCHA into the form template.<\/p>\n\n\n\n

    How to Add Google reCAPTCHA to Custom Form in Magento 2<\/strong><\/p>\n\n\n\n

      \n
    1. Configure Google reCAPTCHA in Magento 2<\/a><\/li>\n\n\n\n
    2. Create a Custom Extension to Display Your Custom Form<\/a><\/li>\n\n\n\n
    3. Add the Magento 2 Custom Form to the List of Frontend reCAPTCHA<\/a><\/li>\n\n\n\n
    4. Integrate Google reCAPTCHA into the Custom Form Template<\/a><\/li>\n\n\n\n
    5. Build a Controller to Handle Custom Form Submissions<\/a><\/li>\n\n\n\n
    6. Validate Google reCAPTCHA for the Custom Form in Magento 2<\/a><\/li>\n<\/ol>\n\n\n\n
      \"\"<\/span>
      \n

      Struggling<\/strong><\/span> to Add Google reCAPTCHA to Custom Forms?<\/strong><\/span><\/p>\n\n\n\n

      Our expert developers can help you seamlessly integrate reCAPTCHA and enhance your form security while minimizing user friction.<\/p>\n\n\n\n

      \n
      Get Help Now<\/a><\/div>\n<\/div>\n<\/div><\/div>\n\n\n\n

      Step 1. \u0421onfigure Google reCAPTCHA on Magento 2<\/h2>\n\n\n\n

      First, register your site at Google reCAPTCHA<\/a>, and select the type of reCAPTCHA you want to use.<\/p>\n\n\n\n

      \"Step<\/figure>\n\n\n\n

      Then, go to Stores > Configuration > Security > Google reCAPTCHA Storefront > reCAPTCHA<\/strong> v2 (“I am not a robot”) \/ reCAPTCHA v2 Invisible \/ reCAPTCHA v3 Invisible<\/strong> and enter the site key and secret key you created on Google reCAPTCHA after registering. Make sure that the setting name in Magento matches the type of Google reCAPTCHA you created (e.g., reCAPTCHA v2 or v3).<\/p>\n\n\n

      \n
      \"Step<\/figure>\n<\/div>\n\n\n

      Step 2. Create a Custom Extension to Display Your Custom Form<\/h2>\n\n\n\n

      We need to create the following files.<\/p>\n\n\n\n

      app\/code\/Vendor\/CustomFormRecaptcha\/registration.php<\/div>
      <?php\nuse Magento\\Framework\\Component\\ComponentRegistrar;\nComponentRegistrar::register(\n   ComponentRegistrar::MODULE, 'Vendor_CustomFormRecaptcha',\n   __DIR__\n);\n<\/code><\/pre><\/div>\n\n\n\n
      app\/code\/Vendor\/CustomFormRecaptcha\/etc\/module.xml<\/div>
      <?xml version="1.0"?>\n<config xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\n       xsi:noNamespaceSchemaLocation="urn:magento:framework:Module\/etc\/module.xsd">\n   <module name="Vendor_CustomFormRecaptcha"\/>\n<\/config>\n<\/code><\/pre><\/div>\n\n\n\n
      app\/code\/Vendor\/CustomFormRecaptcha\/etc\/frontend\/routes.xml<\/div>
      <?xml version="1.0"?>\n<config xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\n        xsi:noNamespaceSchemaLocation="urn:magento:framework:App\/etc\/routes.xsd">\n    <router id="standard">\n        <route id="customformrecaptcha" frontName="customformrecaptcha">\n            <module name="Vendor_CustomFormRecaptcha" \/>\n        <\/route>\n    <\/router>\n<\/config><\/code><\/pre><\/div>\n\n\n\n
      app\/code\/Vendor\/CustomFormRecaptcha\/Controller\/Index\/Index.php<\/div>
      <?php\nnamespace Vendor\\CustomFormRecaptcha\\Controller\\Index;\nuse Magento\\Framework\\App\\ActionInterface;\nuse Magento\\Framework\\App\\Action\\Context;\nuse Magento\\Framework\\View\\Result\\PageFactory;\nclass Index implements ActionInterface\n{\n   \/**\n    * @var PageFactory\n    *\/\n   private $resultPageFactory;\n   \/**\n    * @var Context\n    *\/\n   private $context;\n   public function __construct(\n       Context $context,\n       PageFactory $resultPageFactory\n   ) {\n       $this->context = $context;\n       $this->resultPageFactory = $resultPageFactory;\n   }\n   public function execute()\n   {\n       return $this->resultPageFactory->create();\n   }\n}\n<\/code><\/pre><\/div>\n\n\n\n
      app\/code\/Vendor\/CustomFormRecaptcha\/view\/frontend\/layout\/customformrecaptcha_index_index.xml<\/div>
      <?xml version="1.0"?>\n<page xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View\/Layout\/etc\/page_configuration.xsd">\n   <body>\n       <referenceContainer name="content">\n           <block class="Magento\\Framework\\View\\Element\\Template"\n                  name="customformrecaptcha"\n                  template="Vendor_CustomFormRecaptcha::form.phtml"\n           \/>\n       <\/referenceContainer>\n   <\/body>\n<\/page><\/code><\/pre><\/div>\n\n\n\n
      app\/code\/Vendor\/CustomFormRecaptcha\/view\/frontend\/templates\/form.phtml<\/div>
      <?php \/** @var \\Magento\\Framework\\View\\Element\\Template $block *\/ ?>\n<form action="" method="post">\n   <div>\n       <label for="name">Name:<\/label>\n       <input type="text" name="name" id="name" required\/>\n   <\/div>\n   <div>\n       <label for="email">Email:<\/label>\n       <input type="email" name="email" id="email" required\/>\n   <\/div>\n   <div>\n       <button type="submit">Submit<\/button>\n   <\/div>\n   <input name="form_key" type="hidden" value="<?php echo $block->getFormKey(); ?>" \/>\n<\/form>\n<\/code><\/pre><\/div>\n\n\n\n
      After creating the files, run the following commands:<\/p>\n\n\n\n
      php bin\/magento setup:upgrade\nphp bin\/magento setup:di:compile\nphp bin\/magento setup:static-content:deploy\nphp bin\/magento cache:flush\n<\/code><\/pre>\n\n\n\n
      Now we can see our form following the link: https:\/\/your-website-url\/customformrecaptcha\/index\/index  <\/p>\n\n\n
      \n
      \"Step<\/figure>\n<\/div>\n\n\n
      Step 3. Add the Magento 2 Custom Form to the List of Frontend reCAPTCHA<\/h2>\n\n\n\n
      Create a file app\/code\/Vendor\/CustomFormRecaptcha\/etc\/adminhtml\/system.xml<\/div>
      <?xml version="1.0"?>\n<config xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc\/system_file.xsd">\n   <system>\n       <section id="recaptcha_frontend">\n           <group id="type_for">\n               <field id="customformrecaptcha" translate="label" type="select" sortOrder="600" showInDefault="1" showInWebsite="1" showInStore="0" canRestore="1">\n                   <label>Enable for Custom Form Recaptcha<\/label>\n                   <source_model>Magento\\ReCaptchaAdminUi\\Model\\OptionSource\\Type<\/source_model>\n               <\/field>\n           <\/group>\n       <\/section>\n   <\/system>\n<\/config>\n<\/code><\/pre><\/div>\n\n\n\n
      Clean magento cache.
      php bin\/magento cache:flush<\/code><\/p>\n\n\n\n
      Go to the Magento Admin panel, navigate to Stores > Configuration > Security > Google reCAPTCHA > Storefront<\/strong>, and you will see an option to enable Google reCAPTCHA for our custom form.<\/p>\n\n\n\n
      \"Step<\/figure>\n\n\n\n
      Step 4. Display Google reCAPTCHA in the Magento 2 Custom Form<\/h2>\n\n\n\n
      Create a reCAPTCHA block in the layout file app\/code\/Vendor\/CustomFormRecaptcha\/view\/frontend\/layout\/customformrecaptcha_index_index.xml<\/code>
      After adding the block, the content of file will be the following:<\/p>\n\n\n\n
      <?xml version="1.0"?>\n<page xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View\/Layout\/etc\/page_configuration.xsd">\n   <body>\n       <referenceContainer name="content">\n           <block class="Magento\\Framework\\View\\Element\\Template"\n                  name="customformrecaptcha"\n                  template="Vendor_CustomFormRecaptcha::form.phtml">\n               <block class="Magento\\ReCaptchaUi\\Block\\ReCaptcha"\n                      name="recaptcha"\n                      after="-"\n                      template="Magento_ReCaptchaFrontendUi::recaptcha.phtml"\n                      ifconfig="recaptcha_frontend\/type_for\/customformrecaptcha">\n                   <arguments>\n                       <argument name="recaptcha_for" xsi:type="string">customformrecaptcha<\/argument>\n                       <argument name="jsLayout" xsi:type="array">\n                           <item name="components" xsi:type="array">\n                               <item name="recaptcha" xsi:type="array">\n                                   <item name="component" xsi:type="string">Magento_ReCaptchaFrontendUi\/js\/reCaptcha<\/item>\n                               <\/item>\n                           <\/item>\n                       <\/argument>\n                   <\/arguments>\n               <\/block>\n           <\/block>\n       <\/referenceContainer>\n   <\/body>\n<\/page>\n<\/code><\/pre>\n\n\n\n
      Now let’s output the reCAPTCHA block in the form template.<\/p>\n\n\n\n
      The content of the file app\/code\/Vendor\/CustomFormRecaptcha\/view\/frontend\/templates\/form.phtml<\/code> will change to the following:<\/p>\n\n\n\n
      <?php \/** @var \\Magento\\Framework\\View\\Element\\Template $block *\/ ?>\n<form action="<?= $block->getUrl('customformrecaptcha\/index\/post') ?>" method="post">\n   <div>\n       <label for="name">Name:<\/label>\n       <input type="text" name="name" id="name" required\/>\n   <\/div>\n   <div>\n       <label for="email">Email:<\/label>\n       <input type="email" name="email" id="email" required\/>\n   <\/div>\n   <div>\n       <?php echo $block->getChildHtml('recaptcha'); ?>\n   <\/div>\n   <div>\n       <button type="submit">Submit<\/button>\n   <\/div>\n   <input name="form_key" type="hidden" value="<?php echo $block->getFormKey(); ?>" \/>\n<\/form>\n<\/code><\/pre>\n\n\n\n
      Now we can see Google reCAPTCHA on our custom form.<\/p>\n\n\n\n
      \"Step<\/figure>\n\n\n\n
      Step 5. Build a Controller to Handle Custom Form Submissions<\/h2>\n\n\n\n
      Create file app\/code\/Vendor\/CustomFormRecaptcha\/Controller\/Index\/Post.php<\/div>
      <?php\nnamespace Vendor\\CustomFormRecaptcha\\Controller\\Index;\nuse Magento\\Framework\\App\\Action\\Action;\nuse Magento\\Framework\\App\\Action\\HttpPostActionInterface;\nuse Magento\\Framework\\Controller\\Result\\RedirectFactory;\nuse Magento\\Framework\\Message\\ManagerInterface;\nuse Magento\\Framework\\Exception\\LocalizedException;\nclass Post extends Action implements HttpPostActionInterface\n{\n   protected $resultRedirectFactory;\n   protected $messageManager;\n   public function __construct(\n       \\Magento\\Framework\\App\\Action\\Context $context,\n       RedirectFactory $resultRedirectFactory,\n       ManagerInterface $messageManager\n   ) {\n       parent::__construct($context);\n       $this->resultRedirectFactory = $resultRedirectFactory;\n       $this->messageManager = $messageManager;\n   }\n   public function execute()\n   {\n       $postData = $this->getRequest()->getPostValue();\n       if ($postData) {\n           try {\n               $this->_eventManager->dispatch('customformrecaptcha_validate_recaptcha', ['request' => $this->getRequest()]);\n               \/\/ Save data\n               $this->messageManager->addSuccessMessage(__('Form submitted successfully.'));\n           } catch (LocalizedException $e) {\n               $this->messageManager->addErrorMessage($e->getMessage());\n           } catch (\\Exception) {\n               $this->messageManager->addErrorMessage(__('An error occurred: %1', $e->getMessage()));\n           }\n       } else {\n           $this->messageManager->addErrorMessage(__('No data received.'));\n       }\n       return $this->resultRedirectFactory->create()->setPath('*\/*\/');\n   }\n}\n<\/code><\/pre><\/div>\n\n\n\n
      Step 6. Create an Observer to Validate Google reCAPTCHA for the Custom Form in Magento 2<\/h2>\n\n\n\n
      Create file: app\/code\/CustomFormRecaptcha\/Module\/etc\/frontend\/events.xml<\/div>
      <?xml version="1.0"?>\n<config xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework\/Event\/etc\/events.xsd">\n   <event name="customformrecaptcha_validate_recaptcha">\n       <observer name="validate_recaptcha" instance="Vendor\\CustomFormRecaptcha\\Observer\\ValidateRecaptcha" \/>\n   <\/event>\n<\/config>\n<\/code><\/pre><\/div>\n\n\n\n
      Create file: app\/code\/Vendor\/CustomFormRecaptcha\/Observer\/ValidateRecaptcha.php<\/div>
      \n<?php\nnamespace Vendor\\CustomFormRecaptcha\\Observer;\nuse Magento\\Framework\\Event\\Observer;\nuse Magento\\Framework\\Event\\ObserverInterface;\nuse Magento\\Framework\\Exception\\InputException;\nuse Magento\\Framework\\Exception\\LocalizedException;\nuse Magento\\Framework\\ObjectManagerInterface;\nuse Magento\\ReCaptchaUi\\Model\\IsCaptchaEnabledInterface;\nclass ValidateRecaptcha implements ObserverInterface\n{\n   \/**\n    * @var IsCaptchaEnabledInterface\n    *\/\n   private $isCaptchaEnabled;\n   \/**\n    * @var ObjectManagerInterface\n    *\/\n   private $objectManager;\n   public function __construct(\n       IsCaptchaEnabledInterface $isCaptchaEnabled,\n       ObjectManagerInterface $objectManager,\n   ) {\n       $this->isCaptchaEnabled = $isCaptchaEnabled;\n       $this->objectManager = $objectManager;\n   }\n   \/**\n    * @throws InputException\n    *\/\n   public function execute(Observer $observer)\n   {\n       $key = 'customformrecaptcha';\n       $request = $observer->getRequest();\n       if ($this->isCaptchaEnabled->isCaptchaEnabledFor($key)) {\n           $validationConfigResolver = $this->objectManager->get(\n               \\Magento\\ReCaptchaUi\\Model\\ValidationConfigResolverInterface::class\n           );\n           $captchaResponseResolver = $this->objectManager->get(\n               \\Magento\\ReCaptchaUi\\Model\\CaptchaResponseResolverInterface::class\n           );\n           $captchaValidator = $this->objectManager->get(\n               \\Magento\\ReCaptchaValidationApi\\Api\\ValidatorInterface::class\n           );\n           $validationConfig = $validationConfigResolver->get($key);\n           try {\n               $reCaptchaResponse = $captchaResponseResolver->resolve($request);\n           } catch (InputException $e) {\n               throw new LocalizedException(__('Please complete the reCAPTCHA validation.'));\n           }\n           $validationResult = $captchaValidator->isValid($reCaptchaResponse, $validationConfig);\n           if (false === $validationResult->isValid()) {\n               throw new LocalizedException(__('reCAPTCHA validation failed. Please try again.'));\n           }\n       }\n   }\n}\n<\/code><\/pre><\/div>\n\n\n\n
      Conclusion<\/h2>\n\n\n\n
      By taking these simple steps, you improve not just the functionality of your website but also the confidence your customers have in your brand. Keep optimizing and securing your store to provide the best possible experience for your users.<\/p>\n\n\n\n
      Frequently Asked Questions (FAQ)<\/h2>\n\n\n\n
      Why doesn’t reCAPTCHA appear on my custom form?<\/strong><\/strong> 
      Work through it in this order. First, confirm your form’s field is actually set at Stores > Configuration > Security > Google reCAPTCHA Storefront > Storefront<\/strong>. That field only shows up after the system.xml<\/code> from Step 3 is in place and the cache is flushed. 
      Second, check that the ifconfig<\/code> value on your reCAPTCHA block matches the field ID character for character: recaptcha_frontend\/type_for\/customformrecaptcha<\/code>. 
      Third, flush the cache and redeploy static content. Most of the time it’s a stale cache or a one-character mismatch between the two.<\/p> <\/div> 
      The form submits fine, but reCAPTCHA never blocks anything. What’s wrong?<\/strong> 
      Two usual suspects. Your events.xml<\/code> has to sit at app\/code\/Vendor\/CustomFormRecaptcha\/etc\/frontend\/events.xml<\/code>. Get that path wrong and the observer never registers, so validation silently never runs and everything looks like it’s working. The other suspect is the form key. Magento validates the form key on every frontend POST, so if that hidden input renders empty you get bounced before the observer ever fires. Use $block->getBlockHtml('formkey')<\/code> in your template. $block->getFormKey()<\/code> doesn’t exist on Magento\\Framework\\View\\Element\\Template<\/code> and returns nothing.<\/p> <\/div> 
      reCAPTCHA validation fails for everyone, including real customers. Why?<\/strong> 
      Check php.ini<\/code> first. Adobe requires allow_url_fopen = 1<\/code> before Google reCAPTCHA can work at all, and on locked-down hosting it’s often off. Without it, Magento can’t reach Google’s verification endpoint and every submission fails.<\/p> <\/div> 
      Which reCAPTCHA type should I use for a custom form?<\/strong> 
      Start with v3 Invisible. It scores traffic in the background with nothing for the customer to click, which matters on a form you’re asking people to fill in anyway. Google itself no longer recommends checkbox keys, on the grounds that they add friction without meaningfully improving accuracy. Use v2 only if you have a specific reason to show a challenge. Whichever you pick, the type selected in Magento must match the type of the key you generated, or validation fails with a confusing error.<\/p> <\/div> 
      Does this work on a Hyv\u00e4 storefront?<\/strong> 
      The server side does. Steps 3, 5 and 6 are unchanged. Step 4 is not: Hyv\u00e4 doesn’t load RequireJS or Knockout, so the jsLayout<\/code> component renders nothing. Hyv\u00e4 ships its own blocks for this, recaptcha_validation<\/code>, recaptcha_validation_invisible<\/code> and recaptcha_validation_recaptcha<\/code>. Assign the one matching your reCAPTCHA version as a child of your form block using the alias recaptcha_validation<\/code>.<\/p> <\/div> 
      Does adding reCAPTCHA to more forms cost anything?<\/strong> 
      Once your keys are managed in a Google Cloud project, the free allowance is 10,000 assessments per month, and you’re billed past that. Every protected submission counts against it. Worth checking your volume before you add reCAPTCHA to a high-traffic form like newsletter signup.<\/p> <\/div> <\/div>\n","protected":false},"excerpt":{"rendered":"
      Google reCAPTCHA helps protect websites from spam, bot attacks, and other automated form submissions. <\/p>\n
      Adding reCAPTCHA to your Magento 2 custom forms adds an essential layer of security, ensuring only genuine user interactions are processed by your site.<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[144],"tags":[],"class_list":["post-2264","post","type-post","status-publish","format-standard","hentry","category-magento-backend-dev-guide","entry"],"yoast_head":"\nHow to Add Google reCAPTCHA to Custom Form\u200b in Magento 2<\/title>\n<meta name=\"description\" content=\"Learn how to add Google reCAPTCHA to custom forms in Magento 2 to protect your site from spam and bots with this step-by-step guide.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Add Google reCAPTCHA to Custom Form\u200b in Magento 2\" \/>\n<meta property=\"og:description\" content=\"Learn how to add Google reCAPTCHA to custom forms in Magento 2 to protect your site from spam and bots with this step-by-step guide.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha\" \/>\n<meta property=\"og:site_name\" content=\"Magento Tutorials for Beginners & Professionals\" \/>\n<meta property=\"article:published_time\" content=\"2025-01-10T11:47:51+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-08-19T09:17:50+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2025\/01\/add-google-recaptcha-to-custom-form-1.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1600\" \/>\n\t<meta property=\"og:image:height\" content=\"600\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Volodymyr Holovatskiy\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Volodymyr Holovatskiy\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"6 minutes\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to Add Google reCAPTCHA to Custom Form\u200b in Magento 2","description":"Learn how to add Google reCAPTCHA to custom forms in Magento 2 to protect your site from spam and bots with this step-by-step guide.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha","og_locale":"en_US","og_type":"article","og_title":"How to Add Google reCAPTCHA to Custom Form\u200b in Magento 2","og_description":"Learn how to add Google reCAPTCHA to custom forms in Magento 2 to protect your site from spam and bots with this step-by-step guide.","og_url":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha","og_site_name":"Magento Tutorials for Beginners & Professionals","article_published_time":"2025-01-10T11:47:51+00:00","article_modified_time":"2026-08-19T09:17:50+00:00","og_image":[{"width":1600,"height":600,"url":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2025\/01\/add-google-recaptcha-to-custom-form-1.png","type":"image\/png"}],"author":"Volodymyr Holovatskiy","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Volodymyr Holovatskiy","Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#article","isPartOf":{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha"},"author":{"name":"Volodymyr Holovatskiy","@id":"https:\/\/plumrocket.com\/learn\/#\/schema\/person\/161911374678c2f70335dd5a1efac69f"},"headline":"How to Add Google reCAPTCHA to Custom Form\u200b in Magento 2","datePublished":"2025-01-10T11:47:51+00:00","dateModified":"2026-08-19T09:17:50+00:00","mainEntityOfPage":{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha"},"wordCount":1028,"commentCount":0,"image":{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#primaryimage"},"thumbnailUrl":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2025\/01\/add-google-recaptcha-to-custom-form-1.png","articleSection":["Magento Backend Development"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#respond"]}]},{"@type":["WebPage","FAQPage"],"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha","url":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha","name":"How to Add Google reCAPTCHA to Custom Form\u200b in Magento 2","isPartOf":{"@id":"https:\/\/plumrocket.com\/learn\/#website"},"primaryImageOfPage":{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#primaryimage"},"image":{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#primaryimage"},"thumbnailUrl":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2025\/01\/add-google-recaptcha-to-custom-form-1.png","datePublished":"2025-01-10T11:47:51+00:00","dateModified":"2026-08-19T09:17:50+00:00","author":{"@id":"https:\/\/plumrocket.com\/learn\/#\/schema\/person\/161911374678c2f70335dd5a1efac69f"},"description":"Learn how to add Google reCAPTCHA to custom forms in Magento 2 to protect your site from spam and bots with this step-by-step guide.","breadcrumb":{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#breadcrumb"},"mainEntity":[{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130876253"},{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130915900"},{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130941567"},{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130968285"},{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130980805"},{"@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130999722"}],"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#primaryimage","url":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2025\/01\/add-google-recaptcha-to-custom-form-1.png","contentUrl":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2025\/01\/add-google-recaptcha-to-custom-form-1.png","width":1600,"height":600},{"@type":"BreadcrumbList","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Learn","item":"https:\/\/plumrocket.com\/learn"},{"@type":"ListItem","position":2,"name":"How to Add Google reCAPTCHA to Custom Form\u200b in Magento 2"}]},{"@type":"WebSite","@id":"https:\/\/plumrocket.com\/learn\/#website","url":"https:\/\/plumrocket.com\/learn\/","name":"Magento Tutorials for Beginners & Professionals","description":"Plumrocket Inc","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/plumrocket.com\/learn\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/plumrocket.com\/learn\/#\/schema\/person\/161911374678c2f70335dd5a1efac69f","name":"Volodymyr Holovatskiy","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/avatar_user_7_1729774175-96x96.png","url":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/avatar_user_7_1729774175-96x96.png","contentUrl":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/avatar_user_7_1729774175-96x96.png","caption":"Volodymyr Holovatskiy"},"description":"Magento 2 developer passionate about creating efficient and functional ecommerce solutions. Loves skiing and hiking in the mountains, finding inspiration for new ideas and solutions in web development.","url":"https:\/\/plumrocket.com\/learn\/author\/volodymyr-holovatskiy"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130876253","position":1,"url":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130876253","name":"Why doesn't reCAPTCHA appear on my custom form?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Work through it in this order. First, confirm your form's field is actually set at <strong>Stores > Configuration > Security > Google reCAPTCHA Storefront > Storefront<\/strong>. That field only shows up after the system.xml from Step 3 is in place and the cache is flushed. <br>Second, check that the ifconfig value on your reCAPTCHA block matches the field ID character for character: recaptcha_frontend\/type_for\/customformrecaptcha. <br>Third, flush the cache and redeploy static content. Most of the time it's a stale cache or a one-character mismatch between the two.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130915900","position":2,"url":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130915900","name":"The form submits fine, but reCAPTCHA never blocks anything. What's wrong?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Two usual suspects. Your events.xml has to sit at app\/code\/Vendor\/CustomFormRecaptcha\/etc\/frontend\/events.xml. Get that path wrong and the observer never registers, so validation silently never runs and everything looks like it's working. The other suspect is the form key. Magento validates the form key on every frontend POST, so if that hidden input renders empty you get bounced before the observer ever fires. Use $block->getBlockHtml('formkey') in your template. $block->getFormKey() doesn't exist on Magento\\Framework\\View\\Element\\Template and returns nothing.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130941567","position":3,"url":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130941567","name":"reCAPTCHA validation fails for everyone, including real customers. Why?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Check php.ini first. Adobe requires allow_url_fopen = 1 before Google reCAPTCHA can work at all, and on locked-down hosting it's often off. Without it, Magento can't reach Google's verification endpoint and every submission fails.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130968285","position":4,"url":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130968285","name":"Which reCAPTCHA type should I use for a custom form?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Start with v3 Invisible. It scores traffic in the background with nothing for the customer to click, which matters on a form you're asking people to fill in anyway. Google itself no longer recommends checkbox keys, on the grounds that they add friction without meaningfully improving accuracy. Use v2 only if you have a specific reason to show a challenge. Whichever you pick, the type selected in Magento must match the type of the key you generated, or validation fails with a confusing error.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130980805","position":5,"url":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130980805","name":"Does this work on a Hyv\u00e4 storefront?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"The server side does. Steps 3, 5 and 6 are unchanged. Step 4 is not: Hyv\u00e4 doesn't load RequireJS or Knockout, so the jsLayout component renders nothing. Hyv\u00e4 ships its own blocks for this, recaptcha_validation, recaptcha_validation_invisible and recaptcha_validation_recaptcha. Assign the one matching your reCAPTCHA version as a child of your form block using the alias recaptcha_validation.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130999722","position":6,"url":"https:\/\/plumrocket.com\/learn\/magento-2-add-google-recaptcha#faq-question-1787130999722","name":"Does adding reCAPTCHA to more forms cost anything?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Once your keys are managed in a Google Cloud project, the free allowance is 10,000 assessments per month, and you're billed past that. Every protected submission counts against it. Worth checking your volume before you add reCAPTCHA to a high-traffic form like newsletter signup.","inLanguage":"en-US"},"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/2264","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/comments?post=2264"}],"version-history":[{"count":15,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/2264\/revisions"}],"predecessor-version":[{"id":3044,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/2264\/revisions\/3044"}],"wp:attachment":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/media?parent=2264"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/categories?post=2264"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/tags?post=2264"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}