Documentation
Learn Octolyze
From your first crawl to a proven fix — the how, and the reasoning behind it. Every concept ties back to one idea: a decision you can defend.
Read the Docs↓
Getting Started
From Zero to Your First Decision.
An audit starts with one URL — you don’t configure rules, the engine brings its own. In a few minutes you have a decision, not a dump.
Run Your First Audit
- In the app, choose New Project and paste the site’s URL.
- Set the page budget for this crawl — how many URLs to fetch. You can raise it later and re-crawl.
- Optionally connect Google in the same step to add Search and Analytics signals.
- Start the crawl. When it finishes, the Overview opens with your Site Health and the decisions behind it.
Connect Google
Search Console and Analytics turn a technical crawl into a business decision — they tell Octolyze what pages people actually search for and land on.
Connection is OAuth, read-only, and revocable. We ask for the smallest scopes that answer the question, store an encrypted token, and never write to your properties. See Security for the details.
Good to Know
Health is one canonical score, computed the same way on every screen. If two views ever disagree, that’s a bug — not two opinions.
Core Concepts
How Octolyze Thinks.
Four ideas do the heavy lifting: nine specialist brains, a real decision from every signal, honest holds, and coverage you can trust.
The Nine Brains
Octolyze reads a site across nine specialist layers, each answering one question — then a central core reconciles them.
Crawl — can engines reach the page?
Index — should it be indexable?
Page Type — is the rule right for this kind of page?
Link — is authority flowing correctly?
Content — is the page strong enough to rank?
Search — is there real demand? (Search Console)
Behavior — do users care? (Analytics)
Trust — how reliable is this finding?
Answer — can assistants understand and cite it? (GEO)
No single brain issues a verdict alone. The core checks whether the evidence agrees before it names a move.
Signals to Decisions
Octolyze doesn’t count findings and call them priorities. Each issue lands in one of four verdicts:
ProblemValuable, in demand, and blocked — fix.
ExpectedA low-value page correctly excluded — keep.
ReviewThe signals disagree — check.
OpportunityDemand outpaces the page — improve.
Severity is how broken; impact is how much it matters. The next move weighs both.
Not Yet Measured
When a check times out, hits a crawl limit, or lacks the evidence to conclude, Octolyze marks it not yet measured instead of scoring it as a pass.
Why This Matters
An unmeasured signal is nothing, not zero. Counting it as zero would inflate a score on evidence nobody gathered.
Partial Audits
If a crawl stops at its page budget before covering the whole site, the audit is partial — and never measured against a full one as if the site regressed.
A lower score after a smaller crawl is a change in scope, not the site. Comparisons count only the pages both crawls covered, and a partial card points back to your last full audit.
Working the Results
Prove It, Then Share It.
A fix isn’t proven until a re-crawl says so — then it becomes a report you can hand a client with your name on it.
Recrawls & Verifying
Shipping a fix isn’t the same as proving it. Re-crawl the site and Octolyze separates work that shipped from fixes it can verify against fresh evidence — and from states that were expected all along.
Reports & Sharing
Turn any audit into a client-ready report: the executive decision first, the crawl, GSC, GA4, and intent evidence underneath. Publish a white-label link or provision a report-only client account that sees the decision without your workspace.
Ready to try it? Start an audit or browse a sample report.