pagelint
The framework

55 checks. Four sources. Cited.

Every PageLint recommendation traces to a primary source with a confidence rating. Not “best practices” — verifiable claims with named books, peer-reviewed studies, and original eye-tracking research.

01 / 08

Clarity

Can a first-time visitor understand what you do, who it's for, and why they should care — in 5 seconds?

8 checks
CL-1

Single dominant H1 in hero

One H1, visually unmistakable. Multiple competing headlines split attention and dilute message.

Three equal-weight headlines competing in the hero
+One H1 that owns the page
Source · Ogilvy, Confessions of an Advertising Man (1963)
Read deep dive →
CL-3

Hero passes "what is this?" in 5 seconds

A first-time reader must understand the product from H1 + subhead alone, without scrolling.

"Reimagine the future of customer connections"
+"Helpdesk software for small e-commerce stores"
Source · CXL Institute, 5-second test methodology
Read deep dive →
CL-6

No jargon in hero

Banned: leverage, synergize, unlock, transform, revolutionize, disrupt, empower, seamless, intelligent, robust, world-class. Replace with plain words.

Source · CXL · Peep Laja: "Jargon is the first sign of a rookie copywriter."
Read deep dive →
CL-7

H1 doesn't use negation

Don't open with "Don't," "No more," "Stop." Negation forces readers to think the unwanted thought first.

Source · Ogilvy, Confessions Ch. VI
02 / 08

Relevance

Does the page meet visitors where they are — by audience, awareness state, and the language they actually use?

5 checks
RE-1

Page declares ICP within first viewport

Target customer named or implied: role, company size, industry, situation. "For everyone" converts no one.

"The modern way to manage your business"
+"For solo accountants who file <50 returns a year"
Source · Ogilvy + Schwartz · Audience match precondition
Read deep dive →
RE-3

Awareness-level appropriate framing

Lead with PROBLEM for unaware traffic. Lead with MECHANISM for solution-aware. Lead with NAME + DEAL for product-aware. Mismatch is the most expensive copy mistake.

Source · Schwartz, Breakthrough Advertising (1966)
RE-4

Voice-of-customer language

At least one phrase verifiable in real customer language — Reddit, G2, Trustpilot — not internal product naming.

Source · CXL · Joanna Wiebe message-mining
03 / 08

Value

Is the value proposition specific, quantified, focused on one promise, and clearly different from the category leader?

8 checks
VA-1

Hero contains at least one specific claim

Number, percentage, named source, quantitative outcome — not pure adjective.

"Significantly faster reviews"
+"Cut review time by 70%"
Source · Ogilvy + Hopkins, Scientific Advertising
Read deep dive →
VA-2

Hero communicates ONE promise, not three

Distinct value props in hero ≤2. Three+ = committee anti-pattern (everyone got their feature in).

Source · Ogilvy · "Boil down to one promise."
VA-4

Differentiation from category leader explicit

Page says how it's better than the alternative — named or implied. "We're different" is not differentiation.

Source · CXL · Peep Laja, differentiation strategy
VA-6

Benefit-led, not feature-led headlines

Headline mentions the outcome the visitor experiences, not an internal feature.

Source · Ogilvy + CXL
Read deep dive →
04 / 08

Motivation

Does the page channel an existing mass desire and direct attention to its most favorable dimension — or try (and fail) to create new desire?

6 checks
MO-1

Page channels a recognizable mass desire

Connects to existing desire (gain, fear, status, comfort). Schwartz: copy can't create desire — only channel it.

Trying to convince visitors they need a new category of tool
+Connecting to the frustration they already feel daily
Source · Schwartz, Breakthrough Advertising Ch. 1
MO-2

Hero focal attention on most favorable dimension

Above-fold prominently surfaces what's strongest about the offering. What's focal becomes causal.

Source · Cialdini, Pre-Suasion (2016) Ch. 4
MO-3

Self-relevant language present

Hero/early body uses "you" or role-specific references. Self-relevance amplifies attention.

Source · Cialdini, Pre-Suasion Ch. 6
MO-5

Authentic urgency only

Real deadline, real inventory, real cohort cap. "Limited time" that runs forever is fake scarcity.

Source · Cialdini · Speero (Bob & Lush case study: +27.1% revenue)
05 / 08

Trust

Are testimonials, authority signals, and pricing real, specific, and verifiable — or smuggled in?

8 checks
TR-1

At least one named, specific testimonial

Testimonial has name, photo, role, company, specific outcome. "Jane S., happy customer" is not a testimonial.

"Great product! — Jane S."
+"Cut our onboarding time from 3 days to 4 hours." — Jane Smith, Head of Ops, Acme Inc.
Source · Ogilvy + Cialdini + CXL eye-tracking
Read deep dive →
TR-2

Testimonials show similarity to target audience

Featured customers match ICP. Cialdini's similarity amplifier: peers persuade more than celebrities.

Source · Cialdini, Influence Ch. 4 + CXL social proof study
Read deep dive →
TR-4

Authority signals verifiable

Credentials, "as featured in" logos, certifications link to verifiable sources. FTC-actionable if false.

Source · Cialdini, Influence Ch. 5
TR-7

Pricing transparent

Price visible or one click away. "Contact sales" without anchor is friction for transactional offers.

Source · Ogilvy + CXL · Peep Laja: "Always reveal pricing."
06 / 08

Friction

Does the path from interest to action have any unnecessary friction in the CTA, the form, or the contrast against the page?

5 checks
FR-1

Single primary CTA above fold

One dominant CTA. Secondary CTAs subordinate. Two equal-weight buttons confuse the decision.

Two equally-styled CTAs in hero
+One primary CTA, one quiet secondary link
Source · CXL + Ogilvy
FR-2

Primary CTA names action + benefit

Not "Submit" or "Learn more." Specific action + outcome. Peep's TextMagic test: +37.6% from CTA copy alone.

Source · CXL · Peep Laja A/B test
Read deep dive →
FR-3

CTA contrast ≥3:1 against background

Contrast matters. Color doesn't. Kadavy on CXL: "There's no best button color."

Source · CXL + WCAG accessibility
FR-4

Form fields ≤ minimum necessary

Only fields essential for the next step. Forms with ≥7 fields warrant testing reduction.

Source · CXL form-field studies
07 / 08

Distraction

Does the page focus attention on the primary action — or compete with itself through carousels, social icons, and interruptions?

4 checks
DI-1

Hero free of competing CTAs

Above-fold has ≤2 CTAs total. More = committee anti-pattern.

Five buttons of equal visual weight in the hero
+One primary CTA, one quiet "Watch demo" link
Source · CXL + Ogilvy
DI-2

No auto-rotating carousel in hero

Static hero. Motion fights for attention. Birkett on CXL: "Moving images don't do well."

Source · CXL
DI-3

No social media icons above fold

Social icons leak traffic from page. If present, keep below fold or in footer.

Source · CXL distraction analysis
DI-4

No live chat popup in first 30 seconds

Auto-open before user reads hero = anxiety + distraction.

Source · CXL anxiety lens
08 / 08

Dark Patterns

Cialdini calls these "smuggler" patterns — fake invocations of real psychology principles. We flag them. Some are also FTC- or EU-actionable.

8 checks
Smuggler patterns are the only category where a check passing isn't enough — these are violations to remove, not nudges to add.
DP-1

Resetting countdown timer

A countdown that resets when it hits zero is fake scarcity. Princeton dark patterns research. The EU Digital Fairness Act enforces against it.

"Offer ends in 02:14:33" — timer restarts on refresh
+Real deadline tied to a real cohort or inventory
Source · Cialdini · Princeton · EU Digital Fairness Act
DP-2

Static "Only N left" indicator

A stock counter that doesn't decrement is fake scarcity. FTC-actionable under Rule on Use of Consumer Reviews.

Source · Cialdini · FTC 16 CFR Part 465
DP-5

Stock-photo or templated testimonials

Fake reviews. The FTC issues civil penalties up to $50K per violation under 16 CFR Part 465 (Oct 2024).

Source · Cialdini · FTC enforcement
DP-8

Negative descriptive social proof

"Most people don't [desired behavior]" actually PROMOTES the unwanted behavior. The Petrified Forest field study showed a 3× increase in theft.

Source · Cialdini, Petrified Forest study
Methodology

When sources disagree.

Four canonical sources don’t always say the same thing. Where they conflict, here’s how we read them.

Long copy vs short copy

Ogilvy says long copy sells. CXL data shows short pages often win. Both true: Schwartz's awareness state determines which applies. Most-aware audiences need less; unaware need more.

Cialdini's "6 principles" vs "7 principles"

Most blogs still teach 6. We use 7 — Cialdini added Unity (shared identity) in Pre-Suasion (2016). Different from Liking. Worth knowing.

Cialdini influence vs Schwartz channeling

Cialdini shows 7 levers to amplify response. Schwartz says you can't push — only channel existing desire. Schwartz is precondition; Cialdini is amplifier.

"Best practices" don't replicate

Peep Laja: "Best practices suck." Button-color folklore ("green converts!") doesn't survive A/B testing. We flag contrast, not color. Context > rules.

Confidence ratings

How we rate confidence.

Every check ships with one of three labels in the audit, so you can tell folklore from research at a glance.

HIGH
Direct quote from primary source (Ogilvy book, Cialdini chapter, Schwartz text, CXL published study).
MEDIUM
Paraphrased from primary source, consistent across multiple secondary citations.
LOW
Derived extension or inferred from commentary, flagged explicitly in audit.
Framework FAQ

About the methodology.

PageLint audits your landing page copy against 55 checks across 7 lenses: clarity, relevance, value, motivation, trust, friction, and distraction. Paste a URL — PageLint crawls the page, runs every check, and returns a prioritized list of copy fixes ranked by severity. Each flag includes the exact quote from your page and a concrete rewrite. Takes 30 seconds.

Run an audit.

Free first audit. No signup needed.