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:
- Direct embed in your site template
- 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:
- Open the page and confirm the script is present.
- Type a known-invalid address and confirm the widget intercepts the form.
- Try a valid-looking address and confirm normal submission still works.
- 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.