The question a visitor asks in the first five seconds is not "should I buy this?" It is "is this for me?" If the answer is unclear, they leave. Clarity is the precondition for every other lever — trust, motivation, social proof — because none of those levers operate on a visitor who doesn't yet understand what the product is. PageLint runs the Clarity lens first because a page that fails clarity doesn't need better social proof. It needs a rewritten hero. This article explains what the eight Clarity checks test and why each one exists.
Why clarity is the first lens
Ogilvy's arithmetic: five times as many people read the headline as read the body copy. The implication is not to write more headlines — it is to write one better one.
On the average, five times as many people read the headline as read the body copy. When you have written your headline, you have spent eighty cents out of your dollar.
CXL Institute's five-second test formalizes what Ogilvy described as reader behavior: scan the dominant visual element, make a stay-or-go decision, then read or leave. The test asks four questions answerable in five seconds: what does this do, who is it for, what's the CTA, what's the benefit? When participants can't answer those questions from the hero, they leave — and in practice, they do leave. The five-second decision is real.
The Clarity lens operationalizes this sequence into eight checkable conditions. They run in order because the output of earlier checks is a precondition for later ones. CL-1 verifies that a dominant H1 exists. CL-2 verifies that its content communicates a category. CL-3 verifies that the full hero is comprehensible. The remaining five checks address specific failure modes that survive that initial sequence.
CL-1: Single dominant H1 in hero
One H1, visually dominant, semantically marked, in the hero region. Two H1s create a competition for attention that neither wins — eye-tracking splits fixation between them, and the visitor anchors on neither. Zero H1s mean the semantic anchor is missing entirely.
The check is programmatic. It parses the hero DOM and counts <h1> elements. Exactly one is a pass. Zero or more than one is a fail. The most common failure mode is not an absence of headlines — it is an abundance of them. Eyebrow, H1, styled sub-head at H2 weight, a second statement at H1 size, and a CTA with a sentence in it. Each element individually looks reasonable. Collectively they eliminate the hierarchy that makes any one of them the primary signal.
The full argument for CL-1 is in the dedicated article, including the three most common patterns and how to diagnose them from the DOM rather than the visual design.
CL-2: H1 names product category in plain language
The H1 must contain a recognizable category noun or literal benefit phrase. Not metaphor. Not pun. Not "reimagining the future of something."
"Reimagine the future of customer connections" contains no category word. A visitor reading it cannot answer "what does this do?" from the headline alone. "CRM for indie SaaS founders" contains two category signals: the product type (CRM) and the audience (indie SaaS founders). A visitor can answer "what is this?" in one second.
The check is an LLM evaluation: the engine is given the H1 text and asked to identify the product category without any other page context. If it can't, neither can the visitor. Confidence is High when the H1 is clear, Medium when borderline (metaphorical language with category-adjacent terms).
CL-3: Hero passes 'what is this?' in 5 seconds
The CXL four-question test applied to the full hero block: what does this do, who is it for, what's the CTA, what's the benefit? The engine is given the hero text cold — no prior context — and asked to verbalize the product. Its answer is scored against the page's declared ICP and product description from SC-1.
This is the superset check that CL-2 and CL-4 feed into. A page that passes CL-3 has a hero any first-time visitor can decode in five seconds. The LLM acts as a proxy for that visitor's cold read. When the engine produces a confused or wrong answer, the confidence level determines whether to flag it as a definite fail or a warning requiring human review.
If the engine can't answer "what is this?" from five seconds of hero text, neither can the visitor.
The check fails most often on pages with strong visual design but weak copy — the product screenshot carries the explanatory load, but the text doesn't. A visitor on a slow connection, or using a screen reader, or just reading fast, will miss what only the image was saying.
CL-4: Hero answers 'who is it for?'
The audience must be named or strongly implied. "For everyone" is an audience of no one — not because being inclusive is wrong, but because "everyone" eliminates the matching signal that makes a visitor feel addressed.
"For solo founders launching their first SaaS product" narrows and qualifies. The right reader feels directly addressed. The wrong reader self-selects out. Both outcomes are correct. Audience specificity improves conversion among the target segment even when it reduces total visitor count who feel addressed — because the visitors who do feel addressed convert at higher rates.
The check is an LLM evaluation looking for explicit audience naming (job title, company stage, industry, problem type) or strong implication through specific vocabulary. A hero full of developer terminology implies a developer audience even without stating it. A hero using "your team" and "your organization" implies an enterprise buyer. Either form passes CL-4.
CL-5: Sub-head clarifies, doesn't repeat H1
If a subhead exists, it must add concrete information — specific benefit, scope, timeframe, mechanism — that the H1 deliberately left unset. A subhead that restates the H1 in slightly different words is not clarification. It is repetition consuming real estate that could carry load.
The failure mode is common because repeating the concept in softer language feels like reinforcement. It isn't — reinforcement requires new information. The check is an LLM evaluation that measures information delta between H1 and subhead. A delta near zero is a fail.
CL-6: No jargon in hero
The banned list comes from the check definition. Sixteen categories of jargon: leverage, synergize, unlock, transform, revolutionize, disrupt, empower, seamless, intelligent, robust, world-class, leading, best-in-class, next-gen, cutting-edge, innovative, game-changing, paradigm.
Each word substitutes for a specific claim without making one. "Intelligent CRM" says less than "CRM that routes leads based on the topic of your last conversation with each contact." Intelligence is asserted but not demonstrated. The specific mechanism demonstrates it.
The check is programmatic. The parser scans the hero text for banned terms — no LLM needed. This is the only Clarity check that is both programmatic and purely negative: a hero can fail CL-6 while passing every other check. Jargon removal is a direct edit, not a structural rewrite.
CL-7: H1 doesn't use negation as primary frame
"Don't miss out." "No more losing leads." "Stop wasting money on traffic that doesn't convert." Negation in headlines reads as loss-aversion framing, and loss-aversion framing works — but it works better in body copy than in headlines, for a specific reason.
Avoid negatives in your headlines. Headlines are typically read at speed. The 'don't' drops out.
Reading speed strips the modifier. "Don't miss out" scanned quickly leaves "miss out" as the semantic residue. "No more losing leads" leaves "losing leads." The page has primed the reader for the problem, not the solution. The negative was intended to motivate action through loss framing; what it actually does is anchor the reader on the undesired state.
The prescription is not to avoid loss framing — it is to apply it in body copy, where reading speed is lower and the "don't" has time to register. In the headline, positive framing is more reliable because the full sentence gets processed, not just the content words.
CL-7 is a programmatic check. It scans the H1 text for sentence-opening negation patterns: "Don't," "No more," "Stop," "Never again," "Tired of." These specific patterns have the highest rate of modifier-drop at scanning speed. Negation embedded in the middle of a headline ("The CRM that doesn't require a six-month implementation") is not flagged — the structure is different and the modifier is less likely to drop.
CL-8: Mean sentence length below 22 words
Ogilvy's prescription in Ogilvy on Advertising (1983) is direct: "Use short sentences." CXL's readability research puts the comfortable-parsing upper bound for web reading at approximately 22 words per sentence. Above 35 words, comprehension drops measurably. The check is computed across all sentences in the hero region.
The check reports three values: mean sentence length, maximum sentence length, and a flag if any single sentence exceeds 35 words. A mean above 22 is a warning. A max above 35 is a must-fix. The fix is almost always structural: one long sentence contains two or three ideas that each deserve their own sentence. Splitting them doesn't lose information — it makes the same information easier to process.
This is a programmatic check with no LLM component. Word count across sentence boundaries is deterministic. The only edge case is bulleted lists, which the check excludes from the mean calculation because bullet points are not parsed as sentences by readers.
The sequence matters
The eight checks are not independent. They run in order because earlier checks are structural prerequisites for later ones.
CL-1 is a prerequisite for CL-2: the content of the H1 can't be evaluated if there's no single H1 to evaluate. CL-3 is a superset of both CL-2 and CL-4 — if CL-3 passes, CL-2 and CL-4 often pass too, but not always. A page can name the category (CL-2 passes) without naming the audience (CL-4 fails). A page can name the audience (CL-4 passes) without passing the five-second test (CL-3 fails) if the overall hero is too complex to parse quickly.
CL-6, CL-7, and CL-8 are independent of each other and of CL-1 through CL-5. They can run in parallel. A page can pass CL-1 through CL-5 and fail CL-6 because of one jargon word. CL-8 can fail on a page where the H1 is perfect and the subhead is good but the third sentence of the body paragraph runs to 47 words.
What clarity unlocks
A page that passes all eight Clarity checks has a hero that any first-time visitor can decode in five seconds. That is a necessary condition, not a sufficient one. Passing clarity doesn't guarantee conversion — it means the visitor now has enough information to make an initial evaluation. The Trust lens, the Motivation lens, and the Relevance lens operate on that foundation.
Before that foundation exists, they don't. Social proof doesn't convert a confused visitor. A compelling offer doesn't close someone who doesn't yet understand what they're being offered. The Clarity lens is not the most exciting part of copywriting — Cialdini's trust mechanisms and Schwartz's awareness staging have more surface-area for discussion. But clarity is the part that makes everything else work.
If a page fails CL-1 through CL-3, PageLint surfaces those findings before running the remaining lenses. Not because the other checks don't matter. Because fixing clarity first creates the page context that makes the other checks meaningful to evaluate.
Sources cited
Primary:
- Ogilvy, David. Confessions of an Advertising Man. Atheneum, 1963. Ch. VI: "How to Write Potent Copy." (The 80-cents-out-of-a-dollar arithmetic and the negation-in-headlines warning.)
- Ogilvy, David. Ogilvy on Advertising. Crown, 1983. Ch. 7: "Wanted: a renaissance in print advertising." (The sentence-length and readability prescriptions.)
Secondary and corroborating:
- CXL Institute. Five-Second Test methodology and four-question framework. (Operationalization of the five-second visitor decision; basis for CL-3.)
- Hopkins, Claude. Scientific Advertising. Lord & Thomas, 1923. Ch. 6: "Being Specific." (The original argument for specificity over category claims; required reading per Ogilvy; foundational to CL-2 and CL-6.)
Further reading:
- CL-1: Single dominant H1 in hero — full treatment of the structural headline check.
- Hero five-second test — deep dive into CL-3 and the CXL four-question framework.
- Schwartz awareness states — the awareness-state model that gives context to what "clarity" means for different traffic segments.
- PageLint principles — complete framework reference for all 55 checks across 8 lenses.