billahdotdev
2026-08-19

Write for the reader that never runs your JavaScript

AI assistants are becoming a referral channel, and most modern sites are invisible to them for a boring technical reason.

A growing share of the people deciding whether to buy from you never visit your website. They ask an assistant, read the summary, and either make contact or do not. You were either in that summary or you were not.

Most sites are not, and the reason is duller than anyone wants it to be.

Read the rest

Switch off JavaScript and look

Open your site with scripts disabled. If you see a blank page, that is roughly what the assistant sees.

Search engines have spent years building the machinery to render JavaScript, expensively and eventually. The crawlers feeding AI systems are mostly at the beginning of that road. They fetch, they read the text that came back, they move on. A single page application ships an empty shell and fills it in later, which is fine for a person with a browser and useless to a reader that never waits.

If your content only exists after hydration, your content only exists for humans who already found you.

Answer in the first paragraph

The second failure is editorial rather than technical, and it is just as common.

Assistants lift passages that answer a question directly. A page that opens with two paragraphs of throat clearing before it gets to the point offers nothing liftable. A page that states the answer plainly in the opening sentence, then explains it, is quotable in a way the first page can never be.

This is a genuine change of habit. A lot of web writing was shaped by the need to keep a reader scrolling past advertising. That incentive does not exist here, and the writing that performs is the writing that respects a reader who wants to leave as soon as they have their answer.

Be an entity, not a page

The third piece is identity. Structured data lets you say, in a way a machine cannot misread, that you are a specific person or a specific organisation, that this profile and that profile and this other site all belong to the same you, and that the thing you sell has this name and that price.

Without it, an assistant describing you is assembling a guess from fragments. With it, there is something coherent to point at. If you have several sites, tie them together explicitly. A person, an organisation, the products, all linked to each other and all agreeing on the facts.

The short version

Serve real text without JavaScript. Answer the question before you elaborate. Keep your URLs stable. Say who you are in a format a machine can parse. Let the crawlers in.

None of it is new. It is the old discipline of the readable web, which stopped being fashionable for about a decade and quietly became load bearing again.

Writing Back to the start