Settings
This guide covers all configurable settings in QAID.
Theme & Appearance
Accessing Theme Settings
Click your profile avatar in the top-right corner to access theme settings from the user dropdown.
Color Mode
- Light: Light background theme
- Dark: Dark background theme
- System preference is respected by default
Accent Color Choose from multiple accent colors:
- Blue (default)
- Green
- Purple
- Orange
- Pink
- And more
Extension Configuration
Extension API Key Configure your Chrome Extension ID for recording features:
- Click your profile avatar in the top-right
- Find "Extension API Key" in the dropdown
- Enter your Extension ID (from
chrome://extensions) - Click Save
This enables:
- Record & Snap functionality
- User interaction recording
- Test generation from recordings
Project Settings
Accessing Project Settings
- Open a project
- Click Settings in the left sidebar
Basic Project Settings
Project Name
- Change the display name of your project
- Used in UI and reports
Base URL
- The root URL of your website
- All discovered pages are relative to this
- Include protocol (https://)
- Do not include trailing slash
Authentication Settings
Auth Profiles Configure authentication for crawling protected pages:
- Login URL: The URL of your site's login page
- Username Field Selector: CSS selector for the username input
- Password Field Selector: CSS selector for the password input
- Submit Button Selector: CSS selector for the login button
- Username: Login username
- Password: Login password (stored encrypted)
You can create multiple auth profiles for testing different user roles. Set a default profile for crawling.
Environments
Manage multiple environment configurations:
- Development, Staging, Production, or Custom environments
- Each environment can have its own base URL and auth profile
- Production environments enforce production-safe mode
Crawl Settings
Default Max Pages Default limit for page discovery (1-200).
Default Max Depth Default crawl depth (1-10).
JS Wait Time Time to wait for JavaScript to render (milliseconds):
- Fast sites: 1000-2000ms
- Medium: 2000-3000ms
- Heavy JS apps: 3000-5000ms
Test Generation Settings
Production-Safe Mode When enabled:
- Tests only verify visibility and presence
- No form submissions
- No button clicks that modify data
- Safe for production environments
Recommended for:
- Production monitoring
- Sites without test environments
- Read-only test suites
Visual Regression Settings
Default Viewport Screen size for screenshots:
- Desktop: 1920x1080
- Tablet: 768x1024
- Mobile: 375x667
- Custom dimensions
Default Threshold Allowed pixel difference percentage (0-100%):
- 0%: Exact match
- 1-3%: Recommended for most sites
- 5%+: High tolerance for dynamic content
Default Wait Time Milliseconds to wait after page load before capture.
Delete Project
Projects support soft-delete:
- Go to Project Settings
- Click "Delete Project"
- Confirm deletion
- Project moves to Trash and can be recovered within 30 days
To permanently delete, remove from Trash.
Admin Settings
Admin settings are available to users with Admin or Super Admin roles at Admin > Settings.
API Key Configuration
Configure the Anthropic API key for AI features:
- Navigate to Admin > Settings
- Enter the API key
- Click Save
User Management
Manage users via Admin > Users:
- View all users
- Invite new users by email
- Assign system roles (Super Admin, Admin, User)
- Enable/disable user accounts
License Management
View and manage your license at Admin > License:
- Current tier (Growth/Professional/Enterprise)
- Feature availability
- License expiry date
- Activation status
Environment Variables
For self-hosted deployments, configure via environment:
| Variable | Purpose |
|---|---|
ANTHROPIC_API_KEY | Claude API key |
DATABASE_URL | Database connection |
JWT_SECRET | Authentication secret |
DOMAIN | Application domain |
See the full configuration reference in your QAID instance's admin documentation.
Best Practices
Security
- Use strong passwords
- Enable 2FA for admin accounts (Enterprise)
- Review user access regularly
Project Configuration
- Start with conservative crawl limits
- Enable production-safe mode for live sites
- Configure auth profiles before crawling protected areas
- Set appropriate viewport for your users
Performance
- Adjust JS wait time for your site speed
- Use appropriate crawl depth
- Limit pages for initial testing
Related Topics
- Quick Start - Create your first project
- Chrome Extension - Extension configuration
- Dashboard - View project metrics