Guides
Updated 2026-04-077 min read

Widget Install and Troubleshooting

Install the form widget, validate that it fires correctly, and debug the most common embed issues.

Widget install and troubleshooting

The SendSure widget lets you validate addresses before a form submission reaches your app or CRM. A correct install is mostly about loading the script once and targeting the right field.

Choose an install path

There are two common paths:

  1. Direct embed in your site template
  2. Google Tag Manager when marketing or growth teams control deployment

Use one or the other for a given page. Running both usually creates duplicate initialization and inconsistent behavior.

Direct embed checklist

Make sure the script loads after the form field exists in the DOM, or initialize only after the page is interactive.

Confirm:

  • the page includes the correct API key or widget config
  • the form selector matches the real form
  • the email input selector matches the real field
  • no second script injects another instance

GTM checklist

When installing through GTM:

  • fire on the intended pages only
  • verify the tag is not duplicated in another container
  • inspect the final rendered page to confirm only one widget script exists

GTM issues often look like product issues, but the failure is usually in tag timing or duplicate load behavior.

Why validation does not fire

The most common causes are:

  • the form selector does not match after a frontend refactor
  • the email field name changed
  • the script loaded before the field rendered
  • the form is replaced dynamically after the widget attaches

If your UI is client-rendered, recheck any delayed or dynamically mounted form components.

How to test the install

Run these checks in order:

  1. Open the page and confirm the script is present.
  2. Type a known-invalid address and confirm the widget intercepts the form.
  3. Try a valid-looking address and confirm normal submission still works.
  4. Check the browser console for duplicate initialization or selector errors.

When to ask for help

If validation still does not fire, capture:

  • the page URL
  • whether you used direct embed or GTM
  • the form framework or site builder
  • any console errors

Then open the support widget. That context cuts debugging time dramatically.

Troubleshooting in the help center

These support articles are also surfaced in the Chatwoot widget before a conversation starts.

Open help center

Keep reading

More docs from the guides section.