Machine-readable content — CrawlNFix Guide
Machine-readable content: inspect evidence, understand the relevant ai / modern web checks, apply a reviewed manual change and verify the result.
Verify that public facts are available in delivered markup, structured fields and crawlable links. Choose a representative URL and a few statements that a machine should be able to retrieve.
Quick answer
Compare the initial HTML with the visible page. Confirm meaningful headings, explanatory text, links and accurate structured fields. Fix the publishing template when important public content exists only in an image, inaccessible interaction or empty client shell.
Why this matters
A browser screenshot and an HTML response expose different evidence. Making content machine-readable helps inspection and retrieval, but it cannot guarantee search indexing, AI citations or that an explanation is correct.
In-depth explanation
Choose acceptance criteria that can be inspected: the product name appears in the returned H1, its description is readable text and its specification rows remain available without interaction. These conditions are more useful than an arbitrary word target.
Source accessibility, structured-data accuracy and editorial quality need different checks. A long response containing repeated menus is not equivalent to a helpful explanation. Read the extracted evidence and compare it with the intended primary content.
What to check
- Identify the page title, H1, main explanation and links in the initial response.
- Check whether prices, dates and entity names in structured data agree with the visible page.
- Inspect whether important routes use normal links and whether content requires login or an interaction.
Manual fix steps
- Move essential public explanation into semantic text elements in the responsible template. Preserve the useful visual design and accessibility.
- Use real anchors for navigable public URLs and descriptive link text that explains the destination.
- Correct inaccurate structured properties at their source rather than duplicating values in a second component.
- When using server rendering or prerendering, ensure the server returns content for the requested path and not the same homepage for every URL.
Verification checklist
- Request two distinct routes directly and compare their title, H1 and main copy without executing scripts.
- Inspect the browser-rendered versions to confirm the same facts remain visible after hydration.
- Run the relevant scanner again and record its source/coverage warning. Review human usefulness separately from extractable word count.
Workflow resources
Common mistakes
- Replacing a useful interface with keyword-heavy hidden text.
- Serving the homepage body on every detail route.
- Calling extractable text proof of AI visibility.
Practical example
A product specification exists only in a promotional image. The publisher adds an accurate HTML specification table, retains the image with appropriate alternative text and checks that the table is present in both source and the rendered page.
Frequently asked questions
Is more extractable text always better?
No. Useful main content matters. Repeated navigation and interface labels should not be counted as substantive explanation.
Does initial HTML need to contain every interaction?
Interactive features may need scripts. Verify that essential public information and navigation are available through the delivery strategy you intend.
Related diagnostic and explanation
Related guides
All public pages · Diagnostic tools · Fix guides · Run a website scan · Articles · Check library