Discovery
Discovery automatically crawls your web application to find pages, detect user flows, identify UI patterns, and generate documentation.
What is Discovery?
Think of Discovery as an intelligent spider that explores your website:
- Finds all pages by following links
- Detects user flows (login, signup, checkout, etc.)
- Identifies UI patterns (forms, tables, modals, navigation)
- Captures screenshots of every page
- Generates documentation about your app structure
Why Use Discovery?
For New Applications
- Quickly understand the app structure
- Find all user journeys
- Identify areas that need testing
For Existing Applications
- Detect changes between versions
- Find pages you didn’t know existed
- Verify all flows still work
For Regression Testing
- Compare before and after deployments
- Detect UI changes automatically
- Ensure no pages are broken
How Discovery Works
Discovery Configuration
When starting a discovery session:
| Setting | Description | Example |
|---|---|---|
| Base URL | Starting point for the crawl | https://example.com |
| Max Depth | How many levels deep to explore | 3 (homepage → category → product) |
| Max Pages | Maximum pages to discover | 100 |
| Include Patterns | URLs to include | /products/, /blog/ |
| Exclude Patterns | URLs to skip | /admin/, /api/ |
| Screenshot Capture | Take screenshots of pages | Enabled |
Recommended Settings: Start with Max Depth: 3 and Max Pages: 50 for your first discovery. You can increase these for more comprehensive crawls.
Authenticated Discovery
Test authenticated areas using Personas:
- Select a Persona with login credentials
- Discovery logs in automatically
- Crawls protected pages behind authentication
- Discovers user-specific flows
What Discovery Finds
Pages
Every page discovered includes:
- URL and title
- HTTP status code
- Screenshot
- Page elements (links, forms, buttons)
- Load time
User Flows
Automatically detected flows:
- Authentication - Login, signup, password reset
- CRUD Operations - Create, read, update, delete
- Search - Search forms and results
- Navigation - Site navigation patterns
- Checkout - E-commerce purchase flows
- Onboarding - New user orientation
UI Patterns
Identified patterns:
- Forms - Input fields, selectors, submissions
- Tables - Data grids and lists
- Modals - Dialogs and popups
- Navigation - Menus, breadcrumbs, footers
- Cards - Content cards and tiles
Crawl Comparison
Compare two discovery sessions to detect changes:
Before Deployment → After Deployment
↓
Comparison Report:
- New pages: 5
- Removed pages: 2
- Modified pages: 12
- Changed flows: 1Change Severity
Changes are categorized:
- Critical - Broken pages, missing flows
- Major - Significant UI changes, new errors
- Minor - Small content or style changes
CI/CD Integration: Run discovery before and after deployment to catch regressions automatically.
Generating From Discovery Results
1. Generate Test Cases
Automatically create tests from discovered flows:
- Each flow becomes a test case
- Steps are based on the actual journey
- Assertions verify key elements
2. Generate Documentation
AI analyzes results to create:
- Application structure overview
- Flow documentation
- UI pattern inventory
- API endpoint list
3. Export Data
Export discovery results:
- JSON - Machine-readable data
- CSV - Page list spreadsheet
- PDF - Visual report with screenshots
Controlling Discovery
Pause/Resume
Pause a running discovery and resume later:
- Useful for long crawls
- Saves progress
- Resume from where it stopped
Cancel
Stop a discovery and discard remaining work:
- Keeps what’s been discovered so far
- Useful if discovering unwanted areas
Discovery Limits
Discovery counts against your plan quota:
| Plan | Monthly Discovery Sessions |
|---|---|
| Starter | 10 sessions |
| Growth | 50 sessions |
| Pro | Unlimited |
Quota Usage: Each discovery session counts as one, regardless of how many pages are discovered.
Best Practices
- Start Small - Begin with limited depth and pages
- Use Exclusions - Skip admin areas, APIs, and external links
- Schedule Regular Crawls - Weekly or before deployments
- Compare Baselines - Keep a baseline crawl to compare against
- Generate Tests - Don’t just discover - create tests from results!