Documentation
Install allyWay
Add allyWay to your website: where the one line of code goes, how long it takes, and the step-by-step guide for your website platform.
Updated October 22, 2026
You install allyWay by adding one line of code to your website – once, in the part every page uses. This page explains how that works and takes you to the step-by-step guide for your platform.
Before you start
- An allyWay account with your website added – see Set up your first website.
- Access to your website's template or its settings for custom code. Someone else manages your website? Send the installation code to your developer.
How installing works
- One code per website. Every website in your account has its own code, with its own website ID in it. The code of another website won't show the widget.
- Once, for every page. The code goes into the template every page uses, right above
</body>– or into a site-wide field for custom code or scripts, ideally for the end of the page. Without a shared template, every HTML file needs the code. - Any website. The code works on any website that lets you add your own code to every page. If your platform doesn't allow scripts at all, the widget can't be added there.
- A few minutes. Usually 2 to 5 minutes, depending on your platform.
Install the code
Copy your installation code
Select your website in the website switcher, open Installation and click Copy in the Installation code card.
Open the guide for your platform
Pick it from the list below – or, on Installation under Integrations, click View integration for your platform. Connect opens the same guide; it doesn't connect anything automatically.
Paste the code and publish
Paste the code where the guide says, then save and publish your website. If your website uses a cache, clear it.
Verify the installation
Click Verify installation below the Installation code card. Check that allyWay is installed explains what you see.
Installation guides
| Platform guide | Takes about |
|---|---|
| Custom / HTML – Custom Framework on the Installation page | 5 minutes |
| WordPress | 3 minutes |
| Shopify | 2 minutes |
| Wix | 2 minutes |
| Squarespace | 2 minutes |
| Webflow | 2 minutes |
| Joomla | 4 minutes |
| Drupal | 5 minutes |
| TYPO3 | 5 minutes |
| Magento | 3 minutes |
| PrestaShop | 5 minutes |
| BigCommerce | 2 minutes |
| OpenCart | 4 minutes |
| HubSpot | 2 minutes |
Wix, Squarespace and Webflow allow custom code only on paid plans of their own – their guides say which.
Your platform isn't listed? Use the Custom / HTML guide or Install allyWay on any website, and look in your platform's settings for a field like "custom code", "code injection", "footer code" or "scripts".
Other ways to add the code
With a tag manager
A tag manager such as Google Tag Manager can add the widget too, but adding the code directly is more reliable. Paste it into a custom HTML tag (in Google Tag Manager: Custom HTML), let it fire on all pages and publish your container.
- Our server can't find a tag manager's code in your page's HTML. Verify installation then opens your homepage in our checker's browser – that takes about a minute.
- If the tag waits for cookie consent, visitors who don't accept never get the widget, and our checks can't see it. The widget sets no cookies: it only stores the visitor's own widget choices in their browser.
- Some ad and privacy blockers block tag managers, so those visitors don't get the widget either.
In a single-page app
In an app built with React, Vue, Angular or Next.js, add the code once to the main HTML page – for example index.html or the root layout – not inside a component that is shown and hidden. The widget then stays on screen while visitors move between your app's pages.
Check that it works
Open your published website and look for the widget button. It appears only on the address you added in allyWay (with or without www) and its subdomains – not on your platform's own address, such as "yoursite.webflow.io". Once allyWay finds your code, Installation shows Active.
No button? Look at your live page's source (right-click › View page source) and search for "loader.js". If it isn't there, the change wasn't published or a cache still serves the old page.
Do I have to update the code after I change the widget's settings?
No. A website's code never changes while the website is in your account. Changes you save in the dashboard – color, position, tools, language – reach visitors the next time a page loads.
I removed my website and added it again. Why doesn't the widget show?
A website you add again is a new website in allyWay, with a new code. Copy it from Installation, replace the old code on your website and publish – Verify installation tells you if the old code is still there. Removing a website deletes its settings, check results and AI fixes for good.
Is my installation code secret?
No. Anyone can see it in your page's source, like any website script. But it only works on the address you added in allyWay (with or without www) and its subdomains, so nobody can use your plan or your settings on their website.
I already use another accessibility tool. Can I keep it?
It works technically, but we don't recommend it: visitors would see two accessibility buttons, and two tools changing the same things, like text size or contrast, can get in each other's way. Remove the other tool's code when you add allyWay, then cancel its subscription with its provider.