Your First Accessibility Scan

This guide will walk you through adding your first website and running your initial accessibility scan with Agora.

Before You Begin

Ensure you have:

• ✅ Agora installed and running
• ✅ Successfully authenticated with your QualiBooth account
• ✅ Active Agora license
• ✅ Admin or Power User role (required to add websites)

Step 1: Add Your First Website

From the Dashboard

1. Navigate to Dashboard: After logging in, you'll see the main dashboard
2. Click "Add Website": Look for the "+ Add Website" button or card
3. Fill Website Details:
   • Display Name: A friendly name for your website (e.g., "Company Homepage")
   • Website Name: Technical identifier (usually the domain name)
   • URL: The main URL to test (e.g., https://example.com)
   • Sitemap URL (optional): URL to your XML sitemap for automatic page discovery

Website Configuration

Display Name vs Website Name:

• Display Name: What you see in the interface ("Company Homepage")
• Website Name: Internal identifier, usually the domain ("example.com")

URL Requirements:

• Should be the main entry point for your website
• Must be accessible from the internet or your network

Sitemap URL Benefits:

• Automatically discovers all pages on your website
• Enables bulk scanning of multiple pages
• Keeps your page list updated as your site changes

Example Configuration

Display Name: My Company Website
URL: https://www.mycompany.com
Sitemap URL: https://www.mycompany.com/sitemap.xml

Step 2: Import Pages (Optional)

If you provided a sitemap URL, Agora can automatically import pages:

Automatic Sitemap Import

1. Click "Fetch URLs": This button is located after you navigate to Website Details view from the dashboard
2. Monitor Progress: You'll see a progress indicator as pages are discovered
3. Review Results: See how many pages were found and imported

Manual Page Addition

If you don't have a sitemap or want to test specific pages:

1. Go to Website Details: Click on your newly added website
2. Navigate to URLs Tab: Switch to the "URLs" tab
3. Click "Add URL": Use the "+ Add URL" button
4. Enter Page URL: Add the specific page you want to test

Page Import Tips

• Start Small: For your first scan, consider testing just a few key pages
• Include Variety: Test homepage, content pages, forms, and interactive features
• Check Accessibility: Ensure test pages represent your site's accessibility challenges

Step 3: Configure Basic Settings

Before running your first scan, review these settings:

Scanning Options

1. Go to Settings: Click the gear icon or navigate to Settings
2. Review Scanning Tab:
   • Headless Mode: Enabled by default for faster scanning
   • Page Scrolling: Enable if your pages have lazy-loaded content
   • WCAG Rules: Choose AA (recommended) or AAA compliance level

Recommended First-Time Settings

✅ Use Headless Mode: ON (faster scanning)
✅ Enable Page Scrolling: OFF (unless you have lazy content)
✅ WCAG 2.2 Rules: ON (latest standards)
❌ AAA Rules: OFF (very strict, start with AA)

Step 4: Run Your First Scan

Single Page Scan

To test a single page first:

1. Navigate to Website: Click on your website from the dashboard
2. Go to URLs Tab: View your imported or manually added pages
3. Click Scan Icon: Look for the scan/play button next to a URL
4. Monitor Progress: Watch the scanning indicator

Multiple Page Scan

To scan multiple pages at once:

1. Click "Scan All URLs": Button in the URLs tab
2. Choose Scan Options:
   • Scan All: Every page in your website
   • Scan Unscanned: Only pages that haven't been tested yet
3. Confirm and Start: Click "Start Scan" to begin
4. Track Progress: Monitor the scan progress in real-time

What Happens During Scanning

1. Page Loading: Agora loads each page in a headless browser
2. Content Analysis: The axe-core engine analyzes the page structure
3. Violation Detection: Accessibility issues are identified and categorized
4. Screenshot Capture: Visual snapshots are taken for reference
5. Results Storage: Findings are saved to your local database

Step 5: Review Your Results

Accessibility Score

Each scanned page receives an accessibility score:

• 85-100: Good, with minor issues
• 60-85: Significant accessibility problems
• Below 60: Poor accessibility — major barriers for users with disabilities.

Understanding Violations

Violations are categorized by severity:

Severity	Description	Priority
Critical	Blocks users with disabilities	Fix immediately
High	Significant barriers	High priority
Medium	Noticeable issues	Medium priority
Low	Best practice improvements	Low priority

Viewing Detailed Results

1. Click on a URL: Select a scanned page from your results
2. Review Violations: See detailed information about each issue
3. View Screenshots: Visual context for identified problems
4. Access Code Examples: Get specific guidance for fixes

Step 6: Explore Key Features

Browser View

1. Navigate to Live Scan: Interactive web browser within Agora
2. Load Your Website: Enter your URL to browse and test live
3. Real-Time Scanning: See violations highlighted as you browse
4. Mobile/Desktop Views: Toggle between viewport sizes

AI Features (If Available)

With an AI license, you can access:

1. Screen Reader Simulation: See how screen readers navigate your site
2. Accessibility Attributes: AI analysis of ARIA labels and attributes
3. Intelligent Insights: AI-powered recommendations for fixes

Export Your First Report

1. Select Website or URL: Choose what to include in your report
2. Click Export: Look for the "Download report" button
3. Download Results: You report will be saved to the downloads folder

Common First-Time Questions

"Why is my score lower than expected?"

• Accessibility testing is comprehensive and strict
• Even small issues can impact the score
• Focus on fixing critical and serious issues first

"Some violations seem incorrect"

• Automated testing has limitations
• Review each violation for context
• Some issues may be false positives requiring manual verification

"How often should I scan?"

• Scan after any content or design changes
• Regular scans (weekly/monthly) for ongoing monitoring
• Before major releases or deployments

"Can I test internal/private websites?"

• Yes, if Agora can access them from your network
• Consider authentication requirements for protected pages
• Use the authentication browser feature for login-protected sites

Next Steps

Now that you've completed your first scan:

1. Explore the Dashboard: See how your results appear in the overview
2. Learn Website Management: Add more websites and organize your testing
3. Deep Dive into Features: Explore advanced scanning and AI capabilities
4. Set Up Reporting: Configure automated reports for your team

Recommended Learning Path

1. Dashboard Overview - Understand your accessibility metrics
2. Website Management - Organize multiple websites
3. Accessibility Testing - Advanced scanning techniques
4. Browser View - Interactive testing capabilities
5. Reports & Export - Share results with your team

Getting Help

If you encounter issues during your first scan:

• Check the URL: Ensure your website is accessible
• Review Settings: Verify scanning configuration
• Monitor Resources: Large sites may take time to scan
• Contact Support: Use the help resources if problems persist

Congratulations on completing your first accessibility scan! You're now ready to explore Agora's full capabilities.