Interaction Steps & Page States

Interaction steps let you configure how navable accesses pages that require authentication or specific interactions before they can be audited. Each step is a browser action (click, type, navigate) that navable performs to reach the desired page state.

When Do You Need Interaction Steps?

You need interaction steps when your pages:

• Require login — The page is behind an authentication wall.
• Need cookie consent — A cookie banner must be dismissed before the content is visible.
• Have multi-step navigation — The content is reached via tabs, modals, or other interactive elements.
• Show different states — The page looks different based on user role, preferences, or other conditions.

How It Works

1. Store secrets — Save login credentials as secrets in Settings → Audit Settings. See Secrets.
2. Define interaction steps — Specify the sequence of browser actions needed to reach the target page state. Steps can be created manually or discovered automatically by AI.
3. Configure per browser profile — Each browser profile (Desktop, Mobile) can have its own set of steps.
4. Test the steps — Verify that the steps work correctly by running a test. You'll see screenshots at each stage.
5. Run the audit — When navable audits the page, it executes the interaction steps first, then performs the accessibility scan on the resulting page state.

Step Types

Step Type	Description	Example
Navigate	Go to a URL	Navigate to the login page
Click	Click an element	Click the "Sign In" button
Type	Enter text into a field	Type username into the email input
Wait	Wait for an element or duration	Wait for the dashboard to load
Select	Choose a dropdown option	Select "Admin" from the role dropdown

Where to Configure

• Per-URL steps — Click Set up on any URL in the Accessibility Overview table to configure steps for that specific page. See Interaction Steps.
• Global steps — Click Global Interaction Steps above the URL table to define steps that run before every URL.
• Global first toggle — Enable this on individual URLs to run global steps before URL-specific steps.

Browser Profiles

Steps are configured per browser profile. If you have both Desktop and Mobile profiles active, you can define different step sequences for each. The Interaction steps column in the URL table shows how many profiles have steps (e.g., "2/2 Profiles").

Configure browser profiles in Settings → Audit Settings. See Settings.

Next Steps

• Secrets — Store login credentials for authenticated page access.
• AI Step Discovery — Let AI automatically discover the steps needed to reach your page state.