Possible Causes:

• Max pages limit reached
• Crawl depth too shallow
• Exclude patterns blocking pages
• Pages require authentication
• JavaScript-rendered content

Solutions:

• Increase the Max Pages setting
• Increase the Depth setting
• Review and adjust exclude patterns
• Set up pre-authentication cookies in Test Data
• Enable JavaScript execution (enabled by default)

Possible Causes:

• Your website has slow response times
• Many pages to crawl
• Heavy JavaScript on pages
• Rate limiting on your server

Solutions:

• Reduce max pages for faster results
• Use Single Page mode for quick tests
• Whitelist AegisRunner IP if you have rate limiting
• Contact support for performance optimization

Possible Causes:

• Monthly crawl limit reached
• Invalid base URL
• Website is unreachable

Solutions:

• Check your usage in Settings → Usage
• Verify your project's base URL is correct
• Ensure your website is accessible from the internet
• Upgrade your plan if you've reached limits

Possible Causes:

• Forms rendered by JavaScript after page load
• Forms inside iframes
• Forms using Shadow DOM
• Non-standard form implementations

Solutions:

• Wait times are automatic, but complex JS may need more time
• Iframes are not currently supported - forms must be in main document
• Report Shadow DOM forms to support for future support
• Manually create test data for non-detected forms

Possible Causes:

• Selector has changed in your application
• Element hasn't loaded yet (timing issue)
• Element is hidden or in a different state
• Page navigation didn't complete

Solutions:

• Check if your application's HTML structure changed
• Use more stable selectors (data-testid, IDs)
• Add explicit wait conditions
• Regenerate tests after significant UI changes

Possible Causes:

• Website is slow to respond
• Long-running operations (file uploads, etc.)
• Infinite loops or hanging requests
• Network issues

Solutions:

• Check your website's performance
• Increase timeout values for slow operations
• Look for JavaScript errors in your application
• Check for failing API calls

Possible Causes:

• Race conditions in your application
• Time-dependent logic
• Shared test state
• External dependencies

Solutions:

• Add proper wait conditions for async operations
• Use test data with deterministic values
• Ensure tests are isolated (no shared state)
• Mock external services when possible

Possible Causes:

• Pre-auth cookies not set or expired
• Session expired during test
• Cookies set for wrong domain

Solutions:

• Update pre-authentication cookies in Test Data
• Ensure cookie domain matches your site
• Create a login user flow that runs first
• Use longer session timeouts for test accounts

Cause: You've reached your plan's project limit.

Solutions:

• Delete unused projects
• Upgrade to a higher plan
• Check your usage: Settings → Usage

Cause: Team member limit reached or wrong role.

Solutions:

• Check team member limits for your plan
• Remove inactive team members
• Only Owners and Admins can invite members
• Upgrade to Pro or Business for more team members

Possible Causes:

• Insufficient funds
• Card expired
• Bank blocked the transaction

Solutions:

• Update your payment method in Settings → Billing
• Contact your bank if the card should work
• Try a different payment method
• Contact billing@aegisrunner.com for assistance

Cause: Resources exceed new plan limits.

Solutions:

• Delete projects to meet new limits
• Remove team members if over limit
• Upgrade back to previous plan
• Data older than retention period is deleted

Possible Causes:

• Invalid or missing API key
• API key was revoked
• Wrong authorization header format

Solutions:

• Verify your API key in Settings → Security
• Generate a new API key if needed
• Use format: Authorization: Bearer YOUR_KEY
• Ensure key hasn't been accidentally exposed and revoked

Possible Causes:

• Webhook URL is incorrect
• Slack app was removed from workspace
• Channel was deleted or renamed
• Notifications are disabled

Solutions:

• Test the webhook with "Send Test Message"
• Create a new webhook if the old one doesn't work
• Verify notification settings are enabled
• Check Slack app is still installed

Possible Causes:

• API key not set in CI secrets
• Wrong suite ID
• Rate limit exceeded
• Plan doesn't include API access

Solutions:

• Verify API key is properly configured in CI secrets
• Double-check suite ID from AegisRunner
• Add delays between requests if hitting rate limits
• Upgrade to Pro or Business for API access

Solutions:

• Check your internet connection
• Clear browser cache
• Try a different browser
• If persistent, report to support

Cause: Queue backlog on lower tier plans.

Solutions:

• Pro plans get priority queue
• Business plans have no queue
• Avoid peak hours for non-urgent runs
• Upgrade for faster execution