Use this guide to install the UserWay Accessibility Widget through Google Tag Manager (GTM). This method allows you to deploy and manage the widget using your existing GTM container without making direct changes to your website's code.
Before You Begin
You will need:
A UserWay account
Access to your Google Tag Manager container
The UserWay Advanced Embed Code
⚠️ Important: Google Tag Manager requires the Advanced Embed Code version of the UserWay widget. The inline (basic/short) embed code is not supported.
Installation
Sign in to your UserWay Dashboard at https://manage.userway.org/.
Open Embed Code, then copy the Advanced Embed Code for your widget.
Sign in to Google Tag Manager and open the container for the website where you want to install the UserWay widget.
Click Tags, then click New.
Enter UserWay as the tag name and Click Tag Configuration, then choose Custom HTML.
Paste the UserWay Advanced Embed Code into the HTML field.
Click Triggering, then choose All Pages, and Click Save.
Click Submit, Optionally enter a version name and description and Click Publish.
Common Issues with Google Tag Manager (GTM) Installations
Dashboard customizations are not being applied
If changes made in Dashboard > Customization (such as widget position, color, size, or other appearance settings) are not being reflected on your website:
Verify that your GTM installation is using the Advanced script.
The Advanced script is required for GTM installations.
When the Basic script is used through GTM, the widget may still appear on the page, but it can connect to a fallback account instead of your UserWay account.
As a result, dashboard customizations may not be applied to the widget.
To resolve this issue:
Update the GTM tag to use the Advanced script.
Republish the GTM container.
Verify that the widget is connected to the correct UserWay account.
If you are already using the Advanced script:
Check whether attributes such as
data-positionhave been added to the script.Advanced script attributes override the corresponding settings configured in the UserWay Dashboard.
Remove or comment out any conflicting attributes if you want dashboard settings to control the widget's appearance.
The widget does not appear on the website
If the widget is not appearing on your website:
Verify that Google Tag Manager is loading correctly on the page.
Temporarily disable ad blockers, privacy tools, browser extensions, or enterprise security software while testing.
Some of these tools can prevent GTM resources from loading or executing.
When GTM is blocked, it cannot inject the UserWay widget script onto the page.
Test in an Incognito/Private window or a browser profile without content-blocking extensions enabled.
Expected Result
The UserWay Accessibility Widget loads on all pages covered by the selected Google Tag Manager container and trigger.
Need more help?
Contact the UserWay Support Team — we're here to assist you.
Get in touch with UserWay Support.