From 763b33491d092103eea0479e18fdebd3f174f08e Mon Sep 17 00:00:00 2001
From: Chris Taylor <forgetso86@gmail.com>
Date: Thu, 21 May 2026 17:28:48 +0100
Subject: [PATCH] docs: pair <script type="module"> with <script nomodule>
 fallback
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Ahrefs and other crawlers that don't execute ES module scripts
currently skip the Procaptcha bundle entirely on customer pages,
so the widget never mounts and the outbound link is never indexed.
Google Search Console shows 100+ customer domains linking to
prosopo.io; Ahrefs shows zero of them.

Updates the recommended snippet in all four EN docs that show the
script include so customers ship both a module and a nomodule
script tag. The nomodule fallback points at the new IIFE bundle
(prosopo/captcha PR for the artifact:
https://github.com/prosopo/captcha/pull/2574).

Also fixes three snippets that were `<script src="..." async defer>`
with no `type="module"` — those were broken against the ES-module
bundle that customers actually receive.

Translated docs (de, it, pt-br, etc.) reference the same snippet
and will need sync via lunaria after this lands.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 src/content/docs/en/basics/client-side-rendering.mdx | 10 ++++++++++
 src/content/docs/en/basics/index.mdx                 |  3 ++-
 src/content/docs/en/basics/invisible-captcha.mdx     |  6 ++++--
 src/content/docs/en/demos/client-example-bundle.mdx  |  1 +
 4 files changed, 17 insertions(+), 3 deletions(-)
diff --git a/src/content/docs/en/basics/client-side-rendering.mdx b/src/content/docs/en/basics/client-side-rendering.mdx
index 97f1aeed19dd3..fc137f8778b28 100644
--- a/src/content/docs/en/basics/client-side-rendering.mdx
+++ b/src/content/docs/en/basics/client-side-rendering.mdx
@@ -10,8 +10,11 @@ are both fine.
 
 ```html
 <script type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+<script nomodule src="https://js.prosopo.io/js/procaptcha.bundle.iife.js" async defer></script>
 ```
 
+The `nomodule` fallback ensures the widget also loads in environments that do not execute ES module scripts (older browsers, some crawlers).
+
 Now, you can either render the Procaptcha widget implicitly or explicitly.
 
 ## Implicit Rendering
@@ -42,6 +45,7 @@ is solved.
     <head>
         <title>Procaptcha Demo</title>
         <script type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+        <script nomodule src="https://js.prosopo.io/js/procaptcha.bundle.iife.js" async defer></script>
     </head>
     <body>
         <form action="" method="POST">
@@ -75,6 +79,12 @@ id `procaptcha-container` where the widget will be rendered.
             async
             defer
         ></script>
+        <script
+            nomodule
+            src="https://js.prosopo.io/js/procaptcha.bundle.iife.js"
+            async
+            defer
+        ></script>
     </head>
     <body>
         <div id="procaptcha-container"></div>
diff --git a/src/content/docs/en/basics/index.mdx b/src/content/docs/en/basics/index.mdx
index de4cede92e95e..c96a1e50a9bf8 100644
--- a/src/content/docs/en/basics/index.mdx
+++ b/src/content/docs/en/basics/index.mdx
@@ -44,7 +44,8 @@ To add the Procaptcha widget:
 <div>
 
 ```html
-<script src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+<script type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+<script nomodule src="https://js.prosopo.io/js/procaptcha.bundle.iife.js" async defer></script>
 ```
 </div>
 
diff --git a/src/content/docs/en/basics/invisible-captcha.mdx b/src/content/docs/en/basics/invisible-captcha.mdx
index c7097e248ce88..4d50f99a4ff0a 100644
--- a/src/content/docs/en/basics/invisible-captcha.mdx
+++ b/src/content/docs/en/basics/invisible-captcha.mdx
@@ -76,7 +76,8 @@ Add the `procaptcha` class and data attributes directly to your form elements:
 <!DOCTYPE html>
 <html>
 <head>
-    <script src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+    <script type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+    <script nomodule src="https://js.prosopo.io/js/procaptcha.bundle.iife.js" async defer></script>
 </head>
 <body>
     <form>
@@ -116,7 +117,8 @@ For more control over the CAPTCHA lifecycle:
 <!DOCTYPE html>
 <html>
 <head>
-    <script src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+    <script type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+    <script nomodule src="https://js.prosopo.io/js/procaptcha.bundle.iife.js" async defer></script>
 </head>
 <body>
     <form id="demo-form">
diff --git a/src/content/docs/en/demos/client-example-bundle.mdx b/src/content/docs/en/demos/client-example-bundle.mdx
index 3552b46698cdb..b0e2d0bd95526 100644
--- a/src/content/docs/en/demos/client-example-bundle.mdx
+++ b/src/content/docs/en/demos/client-example-bundle.mdx
@@ -21,6 +21,7 @@ the [Prosopo portal](https://portal.prosopo.io).
         <link href="//cdn.muicss.com/mui-0.10.3/css/mui.min.css" rel="stylesheet" type="text/css" />
         <title>Procaptcha demo: Simple page</title>
         <script id="procaptchaScript" type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
+        <script nomodule src="https://js.prosopo.io/js/procaptcha.bundle.iife.js" async defer></script>
     </head>
     <body>
         <div class="mui-container">
