Example Scan Configuration's

Pre-Configured Scenarios & Use Cases

Here are several common and advanced scenarios with pre-configured settings for the Accessibility Scanner. These examples demonstrate how to combine different options to achieve specific testing goals.

⚠️ Important Notes Before You Begin:

• Replace Placeholders: You must replace placeholder URLs like https://example.com/your-page with your actual target URLs.
• Test and Adjust: The "Backend Fine-Tuning" values provided are examples. Optimal settings can vary depending on the target site and your machine's capabilities. Start with these and adjust as needed.
• How to Use:
  1. Copy the entire multi-line text block for the scenario you want.
  2. In the Accessibility Scanner UI, expand the "Shareable Scan Configuration" section.
  3. Paste the copied string into the "Paste Configuration String to Apply" text area.
  4. Click the "Apply This Configuration" button. The form will instantly update.
  5. Update the main "URL to Scan" and other relevant URL fields to your actual targets.

1. Deep Dive: Thorough Single Page Analysis

• Goal: Maximum detail on one specific page. Ideal for a critical page like a checkout, a complex form, or a core application screen.
• Focus: Thoroughness and detail over speed.
• Why these settings? Scans all viewports for full responsive coverage, enables all debugging info (elementRef), generates tickets for easy hand-off, uses per-instance screenshots for maximum visual context, and has generous timeouts for complex pages.

--url="<a href="<a href="https://example.com/your-target-page">https://example.com/your-target-page</a>"><a href="https://example.com/your-target-page</a>">https://example.com/your-target-page</a></a>"
--scanOnlyUrlsQuery="<a href="<a href="https://example.com/your-target-page">https://example.com/your-target-page</a>"><a href="https://example.com/your-target-page</a>">https://example.com/your-target-page</a></a>"
--scanAllViewports=true
--generateTickets=true
--elementRef=true
--scanIframes=true
--navigationTimeout=120000
--axeTimeout=60000
--retryAttempts=4
--enableScreenshots=true
--screenshotMode=perInstance

2. Quick Check: Fast Mobile-First Scan

• Goal: Get some accessibility results as quickly as possible on a single page.
• Focus: Speed.
• Why these settings? Targets a single mobile viewport, runs only the most critical WCAG 2.2 A rules, uses parallel scanning, disables screenshots, and sets aggressive timeouts with minimal retries.

--url="<a href="<a href="https://example.com/your-target-page">https://example.com/your-target-page</a>"><a href="https://example.com/your-target-page</a>">https://example.com/your-target-page</a></a>"
--scanOnlyUrlsQuery="<a href="<a href="https://example.com/your-target-page">https://example.com/your-target-page</a>"><a href="https://example.com/your-target-page</a>">https://example.com/your-target-page</a></a>"
--vpWidth=375
--vpHeight=667
--axeTags=wcag22a
--parallelScanning=true
--scanConcurrency=8
--navigationTimeout=20000
--axeTimeout=15000
--retryAttempts=1
--enableScreenshots=false

3. Standard Site Crawl (Balanced)

• Goal: A common starting point for crawling a small to medium-sized website with balanced settings.
• Focus: General discovery and auditing.
• Why these settings? Crawls up to 2 levels deep or 50 pages, targets a standard desktop viewport, uses resource-friendly "per issue type" screenshots, and respects robots.txt as a good crawling citizen.

--url="<a href="<a href="https://example.com">https://example.com</a>"><a href="https://example.com</a>">https://example.com</a></a>"
--vpWidth=1280
--vpHeight=800
--maxDepth=2
--maxCrawlSize=50
--axeTags=wcag22a,wcag22aa
--enableScreenshots=true
--screenshotMode=perType
--respectRobots=true

4. Full Sitemap Scan (Efficient & Comprehensive)

• Goal: Achieve broad coverage of a large site efficiently by using its sitemap.
• Focus: Sitemap processing and parallel analysis.
• Why these settings? Bypasses crawling to use the sitemap, generates tickets, checks for PDFs, and uses parallel scanning to quickly analyze the potentially large list of URLs found in the sitemap.

--url="<a href="<a href="https://example.com">https://example.com</a>"><a href="https://example.com</a>">https://example.com</a></a>"
--sitemapUrl="<a href="<a href="https://example.com/sitemap.xml">https://example.com/sitemap.xml</a>"><a href="https://example.com/sitemap.xml</a>">https://example.com/sitemap.xml</a></a>"
--vpWidth=1280
--vpHeight=800
--generateTickets=true
--axeTags=wcag22a,wcag22aa
--respectRobots=true
--parallelScanning=true
--scanConcurrency=4
--navigationTimeout=60000
--axeTimeout=30000
--checkPdfs=true
--enableScreenshots=true
--screenshotMode=perType

5. Stealthy & Cautious Crawl (For Protected Sites)

• Goal: Attempt to scan sites with strong anti-bot measures (like Cloudflare, Akamai, or Imperva).
• Focus: Evasion and cautious interaction over speed.
• Why these settings? Enables the most advanced Enhanced Stealth mode, introduces a long Crawl Delay, and enables Adaptive Delay to automatically slow down when blocked. It uses multiple custom user agents and has a high retry count with a long initial delay. Disabling GPU (--disableGpu=false) is a deliberate change that can sometimes help bypass certain detection scripts.

--url="<a href="<a href="https://example.com/tricky-site">https://example.com/tricky-site</a>"><a href="https://example.com/tricky-site</a>">https://example.com/tricky-site</a></a>"
--vpWidth=1920
--vpHeight=1080
--maxDepth=1
--crawlDelay=2500
--enableAdaptiveDelay=true
--maxCrawlSize=25
--enhancedStealth=true
--respectRobots=true
--navigationTimeout=120000
--axeTimeout=60000
--retryAttempts=5
--retryInitialDelay=5000
--retryBotBlockMultiplier=5
--customStealthUserAgents="Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/115.0 ;; Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"
--disableGpu=false
--enableScreenshots=true
--screenshotMode=perType

6. Dynamic Content Scan (For SPAs)

• Goal: Reliably test Single-Page Applications (SPAs) where key content loads asynchronously after the initial page load.
• Focus: Handling dynamic content and ensuring accuracy on one page.
• Why these settings? Uses the crucial waitType=selector feature to pause execution until a specific part of the application (#main-app-container.loaded) has rendered, ensuring Axe runs on the final, interactive state of the page.
• User Action: You must replace #main-app-container.loaded with a CSS selector that is unique to your fully-loaded application state.

--url="<a href="<a href="https://spa.example.com">https://spa.example.com</a>"><a href="https://spa.example.com</a>">https://spa.example.com</a></a>"
--scanOnlyUrlsQuery="<a href="<a href="https://spa.example.com">https://spa.example.com</a>"><a href="https://spa.example.com</a>">https://spa.example.com</a></a>"
--vpWidth=1920
--vpHeight=1080
--axeTags=wcag22a,wcag22aa,best-practice
--waitType=selector
--waitValue="#main-app-container.loaded"
--waitSelectorTimeout=45000
--navigationTimeout=90000
--axeTimeout=60000
--enableScreenshots=true
--screenshotMode=perInstance
--generateTickets=true

7. "Internal Audit" Maximum Detail Scan

• Goal: A highly comprehensive "no stone unturned" scan suitable for internal quality assurance before a major release.
• Focus: Maximum coverage, all checks, and detailed reporting.
• Why these settings? Enables all viewports, a deep crawl, all Axe tags, parallel crawling and scanning for speed, and detailed debugging/reporting options. respectRobots=false is set to ensure internal, non-public pages are still checked (use with caution on external sites).

--url="<a href="<a href="https://internal-app.example.com">https://internal-app.example.com</a>"><a href="https://internal-app.example.com</a>">https://internal-app.example.com</a></a>"
--scanAllViewports=true
--maxDepth=5
--maxCrawlSize=1000
--axeTags=wcag2a,wcag21a,wcag22a,wcag2aa,wcag21aa,wcag22aa,best-practice
--elementRef=true
--scanIframes=true
--checkPdfs=true
--generateTickets=true
--enableScreenshots=true
--screenshotMode=perInstance
--parallelCrawling=true
--concurrency=4
--parallelScanning=true
--scanConcurrency=4
--respectRobots=false

8. CI Pipeline Quick Check (Regression Focus)

• Goal: A fast, targeted scan suitable for a Continuous Integration (CI) pipeline to catch major accessibility regressions quickly.
• Focus: Speed, critical pages, and consistency.
• Why these settings? Scans only a small, critical list of URLs, uses a single viewport, disables screenshots and PDF checks for speed, and uses parallel scanning to get results as fast as possible.

--url="<a href="<a href="https://dev.example.com/critical-feature">https://dev.example.com/critical-feature</a>"><a href="https://dev.example.com/critical-feature</a>">https://dev.example.com/critical-feature</a></a>"
--scanOnlyUrlsQuery="<a href="<a href="https://dev.example.com/critical-feature/page1">https://dev.example.com/critical-feature/page1</a>"><a href="https://dev.example.com/critical-feature/page1</a>">https://dev.example.com/critical-feature/page1</a></a> ;; <a href="<a href="https://dev.example.com/critical-feature/page2">https://dev.example.com/critical-feature/page2</a>"><a href="https://dev.example.com/critical-feature/page2</a>">https://dev.example.com/critical-feature/page2</a></a> ;; <a href="<a href="https://dev.example.com/homepage-template">https://dev.example.com/homepage-template</a>"><a href="https://dev.example.com/homepage-template</a>">https://dev.example.com/homepage-template</a></a>"
--vpWidth=1280
--vpHeight=800
--axeTags=wcag22aa
--enableScreenshots=false
--checkPdfs=false
--navigationTimeout=45000
--axeTimeout=30000
--retryAttempts=2
--parallelScanning=true
--scanConcurrency=4