Troubleshooting

Generation didn't finish

If generation hangs at one phase for more than 10 minutes, the phase has likely failed silently.

Click Retry in the status pane — most failures clear on retry.
Try a different starting URL if the issue keeps recurring (some sites have unusual structures that confuse the scraper).
Contact support with the project ID if retries don't help.

Custom domain not working

Most "domain isn't loading" issues are DNS:

Check the DNS record propagated: dig docs.yourcompany.com CNAME should return cname.docsio.co.
Wait 5-15 minutes after creating the record.
Refresh project settings → Custom domain — Docsio re-checks every minute.
CAA records on your apex domain can block SSL issuance. Either remove them or add 0 issue "letsencrypt.org".
If using Cloudflare proxy (orange cloud), set SSL/TLS mode to Full or Full (strict) — not Flexible.

→ Custom domains details

AI agent isn't responding

You hit the free monthly limit. 10 messages/month per project on Free. Resets the 1st of the month.
The agent is busy on a long task. Edits that touch many files take 30-60 seconds. Wait.
Mid-conversation context overflowed. Refresh the chat (settings → Reset chat history). Old context is preserved as a snapshot.

Publish failed

The publish modal shows the failure step — usually a transient build error.
Click Retry on the modal.
If retries don't help, your previous successful version is still live. Contact support with the project ID and the error message.

GitHub sync says "Branch protection rules"

Your branch has rules requiring PR reviews or status checks. Either grant the Docsio app permission to bypass rules in your repo settings, or change the rules to allow direct commits to that branch from docsio[bot].

GitHub push didn't trigger a rebuild

Check the webhook delivered: github.com → repo settings → Webhooks → recent deliveries.
Check the project is still connected: Docsio settings → GitHub → status should be Active.
Confirm the commit was on the configured branch (not a different branch).
Check the commit author — Docsio's own commits (docsio[bot]) are intentionally skipped to avoid loops.

Editor shows old content

Refresh the page (Cmd+R / Ctrl+R). The editor occasionally caches state. If still wrong, log out and back in.

Live preview not updating

Hit refresh in the preview pane's top bar.
If still stale, the preview sandbox needs a kick. Settings → Editor → Restart preview.
Heavy edits (50+ files at once) take 30-60 seconds to rebuild. Wait.

Logo / favicon not appearing

After uploading a new logo or favicon, republish the site once. The publish step is what propagates branding changes to the live site.

Search isn't finding new pages

The search index rebuilds on publish. Republish after adding pages and the search picks them up within a minute.

It's Pro-only. Check the project plan.
Toggle is in project settings → Features → AI chat widget. Off by default; enable.
Republish after enabling — the widget script is added at build time.

I deleted the wrong page

Free plan: not recoverable from the UI. Recreate the page (the AI agent can rewrite it from your URL or files).
Pro plan: project settings → Versions → roll back to before the delete. See Version history.

I want to delete a project entirely

Project settings → Danger zone → Delete project. Confirms before deletion. Custom domain is released. Backup retained for 30 days in case of accident — contact support to restore.

Still stuck?

Contact support. Real person, fast response. Include your project ID — it's in the URL of the editor (docsio.co/project/<id>).