Troubleshooting Web2Phone Forms

If your form isn’t sending, WhatsApp messages aren’t arriving, or you’re seeing “domain not allowed”, this guide walks you through the most common fixes step by step.

For setup instructions, see the Getting Started guide or the platform-specific docs (GitHub Pages, Cloudflare Pages, Webflow, WordPress, etc.).

1. Quick Checklist

Before diving into specific issues, confirm these basics:

You created a form in the Web2Phone dashboard.
You used the embed snippet from your form settings (HTML + JS).
Your site’s hostname is listed under Allowed Domains (no https://, no www., no slashes).
You’re testing on the live site, not only in a preview mode.
Your WhatsApp number is in full international format (e.g. +4479...).

2. “Domain not allowed” or Silent Failures

If you see a “domain not allowed” message, or nothing happens when you submit, the most common cause is an incorrect Allowed Domains entry.

How Allowed Domains should look

Enter only the hostname — no protocol, no www., no paths:

example.com
yourusername.github.io
myapp.pages.dev
yourproject.webflow.io
your-store.myshopify.com

Common mistakes:

❌ https://example.com
❌ www.example.com
❌ example.com/contact
❌ *.example.com (wildcards are not supported)

How to fix it

Open your form in the Web2Phone dashboard.
Look at the URL in your browser’s address bar for your live site.
Take just the hostname part and add it to Allowed Domains.
Click Save, then reload your site and test again.

3. Form Submits, but No WhatsApp Message

If the form appears to submit but you don’t get a WhatsApp message:

Step 1 — Confirm WhatsApp delivery is enabled

Open your form in the Web2Phone dashboard.
Go to the Delivery or Settings section.
Make sure WhatsApp Delivery is turned on.

Step 2 — Check your phone number format

Your number must be in full international format:

+447912345678   ✅ Correct (UK example)
07912345678     ❌ Wrong
+44 7912 345678 ❌ Remove spaces

Step 3 — Check if email is working

If you receive the email notification but not WhatsApp, the issue is very likely with the phone number or WhatsApp configuration.

4. No Email Notification

If WhatsApp works but email doesn’t:

Check that you added at least one email address to the form settings.
Check your spam/junk folder.
Make sure the address is spelled correctly (no stray spaces).

If you’re using custom email routing (e.g. forwarding, aliases), test sending a normal email to that address to confirm it can receive messages.

5. Form Does Nothing / JavaScript Errors

If the button does nothing, or you see an error in the browser console, usually the embed snippet isn’t included correctly.

Check you’re using the full embed snippet

Your form should look roughly like this:

<form data-web2phone="form"
  data-public-key="YOUR_PUBLIC_KEY"
  data-endpoint="https://web2phone.co.uk/api/v1/submit/">

  <input name="name" placeholder="Your name" required>
  <input name="email" type="email" placeholder="you@example.com" required>
  <textarea name="message" placeholder="Message" required></textarea>

  <button type="submit">Send</button>
  <p data-w2p-output></p>

</form>

<script src="https://web2phone.co.uk/static/formsapp/js/embed.js"></script>

Common problems:

The <script> tag was removed by the page builder.
The data-public-key is missing or incorrect.
You copied only the <form> tag but not the script.

Check the browser console

Open your site → press F12 or Ctrl+Shift+I → go to Console. If you see an error mentioning Web2Phone, the message can help identify what’s wrong (wrong key, blocked script, etc.).

6. Platform-Specific Issues

Some platforms have quirks when embedding custom HTML or scripts. If you’re using one of these, refer to the relevant guide:

Each guide includes platform-specific notes about where to paste the snippet and how to avoid script-blocking issues.

Still Need Help?

If you're still stuck after checking the common problems above, you can contact our team directly.

📩 support@web2phone.co.uk

Create a Free Account