Common reasons button-click tracking doesn’t fire
- GTM container not published - You imported the container but didn’t click Submit → Publish.
- GTM snippet not installed on your site - The GTM code needs to be in your site’s <head> and <body>.
- Button uses JavaScript navigation instead of href - If the button navigates via
window.locationor a framework router, a standard Click URL trigger won’t match because there’s no real anchor link. - CSS text-transform changes the visible text - Your trigger matches “Get Started” but the DOM text is “get started” because CSS
text-transform: uppercaseis applied visually only. - Button is inside an iframe - GTM cannot see clicks inside iframes from a different origin. You need GTM installed inside the iframe’s document as well.
- Dynamic buttons loaded after page load - If the button is injected by JavaScript after the DOM is ready, a trigger that fires on DOM Ready may not attach correctly. Use a Click – All Elements trigger instead.
Step-by-step debugging checklist
- Verify GTM is installed - Visit your site, right-click → View Page Source, search for “GTM-”. If you don’t see it, GTM isn’t installed.
- Check GTM Preview mode - In GTM, click Preview. Navigate your site and trigger the event. Look for your tag in the Tags Fired section.
- Check the trigger - If the tag shows as “Not Fired”, click on it to see which trigger conditions aren’t met.
- Inspect the button element - Right-click the button → Inspect. Note the tag name (
button,a,div), classes, and anydata-*attributes. Make sure your trigger selector matches. - Test with a Click – All Elements trigger - Create a trigger with no filters and check GTM Preview to see what Click variables populate when you click the button.
Squarespace-specific issues
Squarespace generates its own HTML structure for buttons. Button blocks use classes like .sqs-block-button-element. These class names are generally stable across template updates, but always verify with GTM Preview.
Squarespace also supports “Code Injection” (Settings → Advanced → Code Injection) for adding GTM. Make sure your GTM snippet is in the Header injection area, not just in a Code Block on a single page.
How to verify it’s working
- Open GTM Preview/Debug mode
- Navigate to your site
- Trigger the event (click the button)
- Check the GTM debug panel - your tag should appear under “Tags Fired”
- Check GA4 DebugView (GA4 → Admin → DebugView) to confirm the event arrived
Still didn’t work?
Our team can help. Describe what’s happening and we’ll get back to you within 24 hours.