Documentation
Set up your first website
Add your website, pick the widget's color, position and language, then install and verify the code – step by step through the setup after sign-up.
Updated October 23, 2026
After you sign up, a short setup takes you through five screens: add your website, choose the widget's color, position and language, then install the code. It takes a few minutes.
Before you start
- An allyWay account – see Sign up for allyWay.
- Room for a website in your plan – the free trial includes 1 website.
- The address of your live website – our checks only read websites that are publicly reachable.
Set up your website
Enter your website's address
On Add your Domain, type your address into Domain without "https://" and without a page path, for example
example.com. If your website redirects to another domain, enter the domain it redirects to. Click Continue – a red message under the field says if something is wrong.Choose a color
On Choose your color, click a color under Presets, or click Custom to pick any color. Then click Continue. If the setup says "Contrast adjusted for WCAG AA", white text would have too little color contrast on your color, so the widget uses dark text and icons.
Choose the button's position
On Choose your position, click one of the eight spots – bottom right is the default. Pick another spot if something else is already there, such as a chat button. Then click Continue.
Choose the widget's language
On Which language should the widget start in?, click the language the widget starts in. Visitors can still switch to any of the 41 languages in the widget. Optionally, turn on Match your website's language: the widget then opens in the language of the page it's on, if it speaks that language.
Create the widget
Click Create Widget. allyWay saves your website with your choices and starts its first check – free, it doesn't count toward the 10 checks you can start yourself each month.
Copy your code
On Add allyWay to your site, click Copy on the code box. If it says Copy failed, select the code and copy it with Ctrl+C (Windows) or Cmd+C (Mac).
Add the code to your website
In the installation guide – on the right, or below the buttons on a phone – click your platform under Where is your site built?, or Custom / HTML if yours isn't listed. Follow its steps – more in Install allyWay – then save and publish the change. Someone else manages your website? Click Send to developer at the bottom of the guide – we email them the code and the steps.
Verify the installation
Click Verify installation. Our server looks for the code on your website right away, and again about every 15 seconds while this screen is open, for up to 10 minutes.
See your first results
When the screen says "Verified on …", click See your first results: the Overview opens and shows your first check. Then read Your first steps after the setup.
To add another website later, choose Add website in the website switcher at the top of the left menu – the same setup opens.
Check that it works
"Verified on …" means allyWay is installed. Working in another browser tab? The setup tab's title changes to "✓ Website verified · allyWay" once we've found your code. Later, see Check that allyWay is installed.
Troubleshooting
- A red message under Domain says what to change – fix the address and click Continue again.
- "This website is already in your account (with or without www.)." – Click Skip setup: the dashboard opens with that website selected.
- "A website's address can't be changed. Add the other address as a new website." – You went back after Create Widget and typed another address. Type the first one again.
- No room for another website? The first screen says so, with See plans (or Update payment method after a failed payment) and Back to your websites.
- "allyWay isn’t on … yet." – Check that you pasted this website's code and published it, clear your website's cache, then click Try again.
- "… blocked our check (HTTP 403)." – A firewall or bot protection keeps us out: Allow our checker in your firewall.
Do I need to add both the www and the non-www version?
No. example.com and www.example.com are one website for allyWay – add it once, and the widget shows on both with the same code. Enter the version your website really uses: our checks start there.
Can I go back and change my choices?
Yes, with Back. After Create Widget, the language screen's button says Update Widget and saves your changes to the same website – only the address can't change. Later, change color, position and language on the Design page.
What does Skip setup do?
Skip setup (top right) opens the dashboard, for example to install later on a computer. If you typed an address, allyWay first adds that website with your choices so far; the rest keeps the starting value (bottom right, allyWay Blue, English). Your code is always on the Installation page.
Where can I get help during the setup?
Click Need help? at the top right of any setup screen – on a phone at the top, next to the allyWay logo. It opens our support chat, where an AI assistant answers your questions right away. Someone else manages your website? Use Send to developer in the installation guide. See Get help from our team.
Can I add more than one website during the free trial?
No, the trial includes 1 website. To try another one, remove the first on Websites (… › Remove website…) – this deletes its settings, check results and AI fixes. The setup then opens for the new one.