🔐 How to Add Password-Protected Pages | AccessibilityChecker.org Help Center

🧾 Authentication Options

If any of your pages are located behind a login, you will need to indicate that authentication is required.

You will now have the option to choose between:

Basic Authentication. Select this option if any URLs associated with your domain require a Username and Password.
Form Authentication. Select this option if any URLs associated with your domain require users to complete a more detailed form.

💻 Basic Authentication Details

Some websites are protected with a login before anyone can see them. This is called HTTP authentication.

If your site has this kind of protection, our tool needs your login details so it can get past the lock and scan your pages.

Just enter the same Username and Password you normally use for that protected site. These details are only used by our tool to sign in and check your site’s accessibility, nothing else.

⚙️ Form Authentication Details

With form authentication, you will have the option to provide more details, including:

Login URL
Username and Password
Login Form Selector, which indicates a button or URL that needs to be clicked to trigger the login form
Username and Password Field Selectors, which help our tool identify the fields where the username and password need to be inserted
Submit Button Selector, which helps our tool identify which button should be clicked to submit the login request

To find the form selectors, follow these steps:

Open your login page in a browser (like Chrome).
Right-click on the username box and choose Inspect (sometimes called Inspect Element).

A panel will open showing the page’s code.
In that panel, you’ll see a highlighted line of code for the username box. Look for an id or name attribute (e.g., id="user_email" or name="username").
Copy that value, as that’s your Username Field Selector.
Do the same for the Password field. This gives you the Password Field Selector.

Next, right-click on the Login button and inspect it. Again, look for an id, name, or even a class (like class="login-button"). That’s your Submit Button Selector.

If your login form only appears after clicking a link or button (like “Sign In”), inspect that element in the same way. That will be your Login Form Selector.

After filling in the necessary details, you can click on the "Add Domain" button.

site. These details are only used by our tool to sign in and check your site’s accessibility, nothing else.

🔐 Multi-Step Form Authentication

Some login pages don’t show everything at once. For example, you might enter your username, click “Continue,” and only then see the password field. If your site works like this, you can set up Login Steps so our tool signs in the same way a person would, one step at a time.

To set this up:

Open Domain Settings for your domain. You’ll find it in the ⋮ menu next to the domain.
Under Authentication, select Required, then choose Form Authentication.
Enter your Login URL.
Under Login steps, click + Add Step for each action in your login process. Each step is one of two types:
- Click: add the Selector for a button or link that needs to be clicked, such as a “Sign In” or “Continue” button.
- Fill field: add the Selector for the field and the Value to type into it, such as your username or password.
Add the steps in the same order you’d do them yourself. If something is in the wrong place, use the ▲ ▼ arrows to move it, or the 🗑️ icon to remove it.

For example, a typical multi-step login might look like this:

Click #show-login-btn (opens the login form)
Fill field #username with your username
Click #continue-btn
Fill field #password with your password
Click #login-btn

You can find each selector the same way as described above: right-click the element, choose Inspect, and copy its id, name or class.

You can add up to 6 login steps. When you’re done, click Update Domain (or Add Domain if you’re adding a new domain) to save.