Documentation
Troubleshooting
Symptoms, likely causes, and what to do. If your problem is not here, contact support with your project ID.
My scan seems stuck
Most likely it is queued, not stuck. Scans currently run one at a time across the platform, so during busy periods your scan waits before it starts. The queue position is not shown yet.
A scan that has genuinely stalled is detected and cleared automatically after a timeout. Escalate if it has been over an hour with no progress, or if the same scan has been cleared twice.
My scan failed
Check, in order:
- Your site is reachable from the public internet
- It is not behind a login wall, IP allowlist or aggressive bot protection
- robots.txt is not blocking our crawler
- Your domain in Crawlix matches the form your site actually serves
The scan found far fewer pages than my site has
- robots.txt is blocking the crawler. Crawlix obeys it, including rules targeting our crawler specifically
- Pages are not linked internally. The crawler follows links, so orphan pages are not discoverable — which is itself a finding, since they do not rank well either
- Content requires JavaScript and the page under-renders
- A crawl limit on your plan
The scan found issues that are not real
Tell us. A false positive is a bug, not a difference of opinion. Include the exact URL, the issue type, and what you see in view-source.
Common legitimate confusions:
- The issue is on a URL that redirects — check the exact URL reported
- The page changed after the scan ran
- The content is injected by JavaScript and is not in the origin HTML — which is itself the problem, because crawlers that do not run JavaScript see what Crawlix saw
My score changed and I do not know why
The score is issues weighted by severity, so a change should always be explainable by the issue delta.
- Score dropped with no new issues → possibly new pages were discovered, each with their own issues
- Score moved with no issue change → that is a bug. Please report it
Domain verification failed
DNS TXT method
Propagation can take up to 48 hours. Check the record is live before retrying — dig TXT yourdomain.com will tell you.
File upload method
The file must be reachable at the exact path, return HTTP 200, and serve raw content. Check no CDN rule, redirect or authentication wall sits in front of it.
Worth knowing
Verify the same form of the domain you registered. www and the bare domain are different.
The snippet is not detected
- Confirm it is on the page — view source and search for the script tag
- Confirm it is on the page you are testing, not only the homepage
- Check your Content Security Policy. A script-src that does not allow our host blocks it silently — your browser console will show the error
- Purge your CDN or page cache
- Real visitors must load the page. Field Core Web Vitals need actual traffic, and no traffic looks identical to a broken install
CMS connection failed
| Platform | Most common cause |
|---|---|
| WordPress | Application password wrong, or the REST API disabled by a security plugin |
| Shopify | App not installed, or scopes not granted |
| Webflow | API token lacks CMS permissions |
| Ghost | A Content API key was used — Crawlix needs an Admin API key |
| Drupal | The JSON:API module is not enabled |
| GitHub | App not installed on the repository, or no file mappings configured |
Reconnect rather than editing credentials. Stored credentials are encrypted, and a partial update fails in confusing ways.
AI generation failed
Usually transient — retry. Persistent failures normally mean the AI provider is unreachable or not configured on your plan. Crawlix reports that rather than inventing a suggestion.
A fix failed to apply
Check which method it tried:
| Method | Likely cause |
|---|---|
| CMS | Credentials expired, or the page no longer exists at the mapped ID |
| Edge | The edge worker is not configured for this domain |
| Snippet | The snippet is not installed or not loading |
| GitHub PR | No file mapping for that URL, or the branch is protected |
| Manual | Nothing was attempted — it is waiting for you |
The fix applied but the issue is still reported
Check where the fix was delivered. This is the most common confusion in the product, and the distinction is real:
- CMS or merged pull request — the change is in your origin HTML. A re-scan should clear the issue
- Edge — the change is in the response Crawlix proxies, not at your origin. Anyone fetching your site directly sees the original
- Snippet — the change happens in the visitor's browser. A crawler that does not run JavaScript sees the page unchanged
Use curl to see what a crawler sees. See reviewing and applying fixes.
A section shows no data at all
- Rank tracking and competitors need a rank-data provider on your plan. Without one every figure is null and the interface says so, rather than estimating
- AI visibility shows "not configured" unless citation checking is enabled — which means we did not check, not that no citations exist
- Search Console data can take 48 hours, and the property must match your project domain exactly
- Field Core Web Vitals need the snippet installed and real traffic
I did not receive an email
Not currently supported
Transactional email is not currently configured, so welcome messages, team invites, alerts and digests are not being delivered. This is a known gap rather than a fault on your account. Everything remains visible in your dashboard.
Contact support
Open a support ticket from the Help page inside your dashboard. Include your project ID, the URL involved, what you expected, what happened, and roughly when.
Not currently supported
Live chat is not currently configured.