
Website Copy Specialist
- 460 installs
- 37 repo stars
- Updated February 26, 2026
- ncklrs/startup-os-skills
website-copy-specialist is a Claude Code agent skill that drafts structured, conversion-focused marketing copy for SaaS and B2B websites across homepage, pricing, feature, comparison, and demo pages for developers prepar
About
website-copy-specialist is an agent skill from ncklrs/startup-os-skills that applies page-type copy frameworks for SaaS and B2B marketing sites. When invoked, the agent loads guidelines from a rules/ directory organized across 10 page-type prefixes—homepage, feature, about, pricing, comparison, product tour, integration, use case, conversion, and navigation—and applies core frameworks including a 6-step Clarity Hierarchy, a 5-level Message-Market Match table, and prescribed 8-section layouts for homepage and feature pages. The skill covers 9 page types with defined primary goals, tone guidance, and anti-patterns such as we-focused copy and buried CTAs. Developers reach for website-copy-specialist when a product site needs hero messaging, tier differentiation, benefit-led feature copy, or competitive comparison pages before go-live, without relying on a dedicated copywriter.
- 10 section playbooks: homepage, feature, pricing, about, comparison, tour, integration, use case, conversion, and naviga
- Impact-tagged priorities (CRITICAL/HIGH) so you tackle hero and pricing before tour pages
- Benefit-led feature pages, tier differentiation on pricing, and competitive comparison positioning
- Conversion-focused demo/contact/sales enablement copy patterns
- Persona- and vertical-specific use case page framing
Website Copy Specialist by the numbers
- 460 all-time installs (skills.sh)
- +11 installs in the week ending Jul 26, 2026 (Skillselion tracking)
- Ranked #783 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ncklrs/startup-os-skills --skill website-copy-specialistAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 460 |
|---|---|
| repo stars | ★ 37 |
| Security audit | 3 / 3 scanners passed |
| Last updated | February 26, 2026 |
| Repository | ncklrs/startup-os-skills ↗ |
How do you write SaaS homepage and pricing page copy?
Draft and structure high-converting copy across homepage, pricing, features, and conversion pages before you ship or relaunch a product site.
Who is it for?
Engineers or technical founders shipping a SaaS or B2B marketing site who need page-level copy frameworks for homepage, pricing, features, and conversion flows before launch.
Skip if: Skip website-copy-specialist when the task is technical documentation, API references, blog SEO strategy, or long-form content marketing unrelated to product-site conversion pages.
When should I use this skill?
Invoke when a developer asks to write, restructure, or optimize homepage, pricing, feature, about, comparison, integration, use-case, or demo/contact page copy for a SaaS or B2B product website.
What you get
Structured homepage hero messaging, pricing tier copy, feature page sections, comparison page drafts, navigation microcopy, and conversion-focused CTAs aligned to page-type goals.
- Homepage hero and section copy
- Pricing page tier descriptions
- Feature and comparison page drafts
By the numbers
- Organizes copy guidelines across 10 page-type rule prefixes in rules/
- Covers 9 distinct SaaS/B2B page types with goals and CTA patterns
- Defines 8-section homepage and 8-section feature page hierarchies
Files
Website Copy Specialist
Expert website copywriter specializing in SaaS and B2B website pages — from homepage messaging to conversion-focused CTAs across every page type.
Philosophy
Great website copy does four things:
1. Answers "What is this?" — Visitors decide in 3-5 seconds if they're in the right place 2. Creates a clear path — Every page guides toward one primary action 3. Speaks to the visitor — "You" language, not "we" language 4. Reduces friction — Anticipates objections and addresses them proactively
How This Skill Works
When invoked, apply the guidelines in rules/ organized by:
homepage-*— Homepage messaging hierarchy and structurefeature-*— Feature page copy and organizationabout-*— About page storytellingpricing-*— Pricing page copy optimizationcomparison-*— Comparison and alternative pagestour-*— Product tour pagesintegration-*— Integration pagesusecase-*— Use case and solution pagesconversion-*— Demo request and contact pagesnavigation-*— Navigation and microcopy
Core Frameworks
The Clarity Hierarchy
Every page follows the same priority:
1. WHAT (What is this thing?)
↓
2. WHO (Is this for me?)
↓
3. WHY (Why should I care?)
↓
4. HOW (How does it work?)
↓
5. PROOF (Can I trust this?)
↓
6. ACTION (What do I do next?)Message-Market Match
| Audience Awareness | What They Need | Copy Approach |
|---|---|---|
| Unaware | Education on the problem | Lead with pain/problem |
| Problem-aware | Understanding of solutions | Agitate + introduce solution |
| Solution-aware | Why your solution | Differentiation + benefits |
| Product-aware | Confidence to buy | Proof + urgency + offer |
| Most aware | Easy path to action | CTA + friction removal |
Page Types and Goals
| Page Type | Primary Goal | Secondary Goal |
|---|---|---|
| Homepage | Communicate value prop | Route to relevant content |
| Feature page | Demonstrate capability | Drive trial/demo |
| About page | Build trust and credibility | Attract talent |
| Pricing page | Enable purchase decision | Qualify leads |
| Comparison page | Win competitive deals | Capture switch intent |
| Product tour | Visualize the experience | Reduce demo friction |
| Integration page | Show ecosystem fit | Capture integration searches |
| Use case page | Prove relevance to segment | Capture intent by persona |
| Demo/Contact | Convert to conversation | Qualify the lead |
The Specificity Ladder
More specific = more persuasive:
Weak: "Save time"
Better: "Save hours every week"
Strong: "Save 5 hours per week"
Best: "Save 5 hours per week on code reviews"Website Copy Spectrum
| Page | Tone | Focus | Primary CTA |
|---|---|---|---|
| Homepage | Confident, clear | Value + differentiation | Start trial / See demo |
| Features | Educational, demonstrative | Capabilities + outcomes | Try feature / Learn more |
| About | Human, authentic | Story + mission + team | Join us / Contact |
| Pricing | Transparent, helpful | Value per tier | Start trial / Talk to sales |
| Comparison | Confident, factual | Differences + advantages | Switch now / Try free |
| Product tour | Visual, guided | Experience preview | Start free |
| Integration | Technical, practical | Setup + benefits | Connect now |
| Use case | Relatable, solution-focused | Problem + proof | See how |
| Demo/Contact | Helpful, low-pressure | Value of conversation | Book time |
Content Hierarchy by Page
Homepage Sections (Order)
1. Hero (value prop + CTA) 2. Social proof bar (logos) 3. Problem/solution overview 4. Key features/benefits 5. How it works 6. Testimonials/case studies 7. Secondary features 8. Final CTA
Feature Page Sections
1. Feature headline + subhead 2. Hero visual (screenshot/video) 3. Key benefits (3-5) 4. Detailed capabilities 5. Use cases 6. Social proof 7. Related features 8. CTA
Anti-Patterns
- "We" focused copy — "We built" vs "You get"
- Feature lists without benefits — Features tell, benefits sell
- Generic headlines — "Welcome to [Company]" tells nothing
- Buried CTAs — Make the action obvious and repeated
- Missing social proof — Claims without evidence
- One-size-fits-all — Different pages need different voices
- Jargon overload — Write for humans, not search engines
- No clear hierarchy — Visitors scan, they don't read
- Competing CTAs — One primary action per page
- Ignoring objections — Address concerns before they derail
1. Homepage Messaging (homepage)
Impact: CRITICAL Description: Homepage messaging hierarchy, hero sections, value propositions, and visitor routing.
2. Feature Pages (feature)
Impact: CRITICAL Description: Feature page structure, benefit-led copy, capability demonstration, and feature-level CTAs.
3. Pricing Pages (pricing)
Impact: CRITICAL Description: Pricing page copy, tier differentiation, value framing, and purchase facilitation.
4. About Pages (about)
Impact: HIGH Description: Company storytelling, mission statements, team presentation, and trust building.
5. Comparison Pages (comparison)
Impact: HIGH Description: Competitive positioning, alternative pages, switch messaging, and differentiation.
6. Product Tour Pages (tour)
Impact: HIGH Description: Product walkthrough copy, guided experiences, and visual demonstration support.
7. Integration Pages (integration)
Impact: MEDIUM-HIGH Description: Integration landing pages, ecosystem positioning, and technical-adjacent copy.
8. Use Case Pages (usecase)
Impact: MEDIUM-HIGH Description: Use case and solution pages, persona-specific messaging, and vertical positioning.
9. Conversion Pages (conversion)
Impact: CRITICAL Description: Demo request pages, contact forms, sales enablement copy, and conversion optimization.
10. Navigation & Microcopy (navigation)
Impact: MEDIUM Description: Navigation labels, button copy, form microcopy, error messages, and UI text.
About Page Storytelling
Impact: HIGH
The about page builds trust and connection. It answers: "Who is behind this product, and can I trust them?" Done well, it turns evaluators into believers.
About Page Structure
┌────────────────────────────────────────────────────┐
│ 1. OPENING STATEMENT │
│ Who you are + what you believe │
│ (Not "Welcome to our about page") │
├────────────────────────────────────────────────────┤
│ 2. ORIGIN STORY │
│ Why you exist — the problem you saw │
│ The moment that sparked the company │
├────────────────────────────────────────────────────┤
│ 3. MISSION/VISION │
│ Where you're going + why it matters │
│ The change you want to create │
├────────────────────────────────────────────────────┤
│ 4. VALUES/PRINCIPLES │
│ What you believe + how you operate │
│ 3-5 core values with real meaning │
├────────────────────────────────────────────────────┤
│ 5. THE TEAM │
│ Leadership + key team members │
│ Humanizing photos + brief bios │
├────────────────────────────────────────────────────┤
│ 6. TRACTION/PROOF │
│ Customers, funding, milestones │
│ Credibility markers │
├────────────────────────────────────────────────────┤
│ 7. CULTURE GLIMPSE │
│ What it's like to work here │
│ (Optional, good for recruiting) │
├────────────────────────────────────────────────────┤
│ 8. JOIN US CTA │
│ Careers, contact, or newsletter │
└────────────────────────────────────────────────────┘The Three Audiences
Your about page serves three different readers:
| Audience | What They Want | What to Emphasize |
|---|---|---|
| Potential customers | Trust, credibility | Experience, stability, customer focus |
| Potential hires | Culture, mission | Values, team, growth opportunity |
| Partners/investors | Vision, traction | Market insight, momentum, leadership |
Opening Statement Formulas
| Formula | Example | Tone |
|---|---|---|
| We [belief statement] | "We believe software should be invisible" | Mission-driven |
| [Company] [does X] | "Acme builds tools that get out of the way" | Direct |
| [Bold claim] | "The best work happens when tools disappear" | Confident |
| [Question] | "Why does business software hate its users?" | Provocative |
Good Opening Statements
✓ "We believe the best infrastructure is the kind you never think about."
→ Clear belief, implies their approach
✓ "Great products come from teams that talk to their customers."
→ Values-driven, customer-centric
✓ "We're building the financial tools we wished existed."
→ Origin hint, relatable motivation
✓ "Enterprise software should be as good as consumer software.
That's why we exist."
→ Problem → Mission in two sentencesBad Opening Statements
✗ "Welcome to our about page! We're so glad you're here."
→ Wastes prime real estate
✗ "Founded in 2019, Acme Inc. is a leading provider of..."
→ Boring, could be any company
✗ "Our mission is to leverage synergies to drive innovation."
→ Meaningless corporate speak
✗ "We're passionate about helping businesses succeed."
→ Generic, could describe anyoneOrigin Story Framework
The best origin stories follow this arc:
1. THE PROBLEM (Conflict)
"We were [doing X] when we realized [Y was broken]"
2. THE INSIGHT (Turning point)
"We discovered that [unexpected truth]"
3. THE SOLUTION (Resolution)
"So we built [product] to [solve problem]"
4. THE MISSION (Forward look)
"Now we're on a mission to [bigger vision]"Good Origin Story
✓ "In 2019, we were a team of four engineers building a fintech product.
Every week, we'd waste hours hunting for API keys scattered across
Slack, .env files, and sticky notes.
When a leaked credential almost cost us a launch, we knew something
had to change. We looked for a solution that was secure, simple,
and didn't require a PhD in DevOps. It didn't exist.
So we built SecretStash. What started as an internal tool now helps
10,000+ teams ship faster without compromising security.
We're just getting started."Bad Origin Story
✗ "Acme was founded by three Harvard Business School graduates who
identified a gap in the market for enterprise SaaS solutions.
After extensive market research and strategic planning, they
secured $5M in seed funding and began building the platform."
→ No emotion, no problem, sounds like a press releaseMission vs. Vision
| Element | Definition | Example |
|---|---|---|
| Mission | What you do and why | "Make developer tools that ship with confidence" |
| Vision | The future you're creating | "A world where every developer can deploy without fear" |
Good Mission Statements
✓ "We exist to make security invisible."
→ Clear, specific, memorable
✓ "Help teams do their best work, faster."
→ Outcome-focused, concise
✓ "Give every startup enterprise-grade tools."
→ Specific audience, clear valueBad Mission Statements
✗ "To be the world's leading provider of innovative solutions"
→ Generic, unmemorable, vague
✗ "Empowering businesses to achieve digital transformation"
→ Buzzword soup
✗ "Making the world a better place through technology"
→ Grandiose, unclearWriting Meaningful Values
For each value, provide: 1. The value name (2-3 words) 2. What it means in practice (1-2 sentences) 3. How you actually live it (optional example)
Good Values Section
✓ "Default to transparency"
We share context, not just conclusions. Everyone at the company
can see our board decks, financials, and strategic plans.
✓ "Ship, then iterate"
Progress beats perfection. We'd rather ship something good today
and improve it tomorrow than wait for something perfect.
✓ "Talk to users weekly"
Everyone — engineers, designers, founders — talks to customers
at least once a week. It's how we stay grounded.Bad Values Section
✗ "Innovation"
We are innovative.
→ No meaning, no evidence
✗ "Excellence"
We strive for excellence in everything we do.
→ Generic, could be any company
✗ "Integrity"
We operate with the highest integrity.
→ Baseline expectation, not differentiatingTeam Section Best Practices
| Element | Do | Don't |
|---|---|---|
| Photos | Consistent style, approachable | Stock photos, inconsistent sizes |
| Names | Full name, role | Just first names (unclear) |
| Bios | 2-3 sentences, personality | Multi-paragraph resumes |
| Links | LinkedIn, Twitter if active | Every social platform |
| Order | Leadership first, then team | Random order |
Good Team Bios
✓ "Sarah Chen, CEO"
Sarah spent 10 years building infrastructure at Stripe before
starting Acme. She's obsessed with developer experience and
terrible at making sourdough.
✓ "Marcus Johnson, Head of Engineering"
Former Staff Engineer at Notion. Believes the best code is the
code you delete. Runs ultramarathons for reasons he can't explain.Bad Team Bios
✗ "John Smith is a visionary leader with 20+ years of experience
driving strategic initiatives across Fortune 500 companies.
He holds an MBA from Wharton and a BS in Computer Science
from MIT. Prior to Acme, John was Senior Vice President of
Strategic Operations at..."
→ Resume, not personality
✗ "CEO"
[Just a photo and title, no bio]
→ Missed opportunity to build connectionTraction Section Options
| Metric Type | Example | Best For |
|---|---|---|
| Customer logos | "Trusted by teams at..." | Enterprise/B2B |
| User count | "50,000+ developers" | Broad adoption |
| Revenue/growth | "$10M ARR" | Investor/partner audiences |
| Funding | "Backed by Sequoia, a16z" | Credibility signal |
| Milestones | "2M+ deploys processed" | Usage-based products |
About Page CTAs
| Primary Goal | Primary CTA | Secondary CTA |
|---|---|---|
| Recruiting focus | "See open roles" | "Learn about our culture" |
| Customer focus | "Start free trial" | "Contact us" |
| Balanced | "Join us" | "Try the product" |
About Page Checklist
- [ ] Opening statement is specific to your company
- [ ] Origin story shows the problem you saw
- [ ] Mission is clear and memorable
- [ ] Values are specific and backed by examples
- [ ] Team photos are consistent and approachable
- [ ] Bios show personality, not just credentials
- [ ] Traction/proof section builds credibility
- [ ] CTA aligned with page goals (careers/product)
- [ ] Page serves both customers and candidates
Anti-Patterns
- "We" overload — About pages can use "we," but balance with "you"
- Corporate speak — "Synergize solutions" isn't human
- Resume culture — People connect with stories, not credentials
- Missing humanity — Show the people, not just the product
- Generic values — "Innovation, Excellence, Integrity" = nothing
- Stock team photos — Use real photos of real people
- No origin story — Every company has a "why"
- Purely promotional — It's an about page, not a sales page
- Outdated info — Wrong team members, old funding rounds
Comparison and Alternative Pages
Impact: HIGH
Comparison pages capture high-intent "vs" and "alternative" searches. These visitors are actively evaluating options. Win them with honesty, clarity, and confidence.
Types of Comparison Pages
| Page Type | URL Pattern | Example |
|---|---|---|
| Direct comparison | /vs/[competitor] | /vs/notion |
| Alternatives page | /alternatives/[competitor] | /alternatives/asana |
| Category comparison | /compare/[category] | /compare/project-management |
| Migration page | /switch-from/[competitor] | /switch-from/jira |
Comparison Page Structure
┌────────────────────────────────────────────────────┐
│ 1. HEADLINE │
│ "[You] vs [Competitor]" or │
│ "Looking for a [Competitor] alternative?" │
├────────────────────────────────────────────────────┤
│ 2. TL;DR SUMMARY │
│ 2-3 sentence positioning of key differences │
├────────────────────────────────────────────────────┤
│ 3. COMPARISON TABLE │
│ Feature-by-feature breakdown │
│ Fair representation of both │
├────────────────────────────────────────────────────┤
│ 4. YOUR ADVANTAGES │
│ 3-5 areas where you genuinely win │
│ With supporting detail │
├────────────────────────────────────────────────────┤
│ 5. WHEN TO CHOOSE [COMPETITOR] │
│ Honest acknowledgment of their strengths │
│ (Builds trust) │
├────────────────────────────────────────────────────┤
│ 6. SWITCHING STORY │
│ Customer who switched + their experience │
├────────────────────────────────────────────────────┤
│ 7. MIGRATION SUPPORT │
│ How easy it is to switch │
│ Import tools, migration help │
├────────────────────────────────────────────────────┤
│ 8. CTA │
│ "Try free" or "See how to switch" │
└────────────────────────────────────────────────────┘Headline Formulas
| Formula | Example | Tone |
|---|---|---|
| [You] vs [Them] | "Acme vs Notion: Which is right for you?" | Balanced |
| Alternative question | "Looking for a Notion alternative?" | Intent-matching |
| Switching focus | "Switching from Notion? Here's what to know" | Action-oriented |
| Comparison focus | "How Acme compares to Notion" | Educational |
Good Comparison Headlines
✓ "Acme vs Notion: A detailed comparison"
→ Clear, SEO-friendly, balanced
✓ "The Notion alternative built for speed"
→ Differentiator in headline
✓ "Thinking about switching from Asana?"
→ Speaks to visitor intent
✓ "Acme vs Jira: Which project tool fits your team?"
→ Helpful framing, not adversarialBad Comparison Headlines
✗ "Why Acme is better than Notion"
→ Sounds biased, reduces trust
✗ "Acme destroys the competition"
→ Aggressive, unprofessional
✗ "Competitor Comparison"
→ Generic, no SEO value
✗ "The truth about Notion"
→ Sounds like attack marketingTL;DR Summary Approach
Provide an honest, scannable summary:
✓ Good TL;DR:
"Acme and Notion both help teams organize work. The key differences:
Acme is faster and built for developers. Notion offers more
flexibility for non-technical teams. If speed and integrations
matter most, choose Acme. If customization is your priority,
Notion might be better."
✗ Bad TL;DR:
"Acme is simply better than Notion in every way. Here's why you
should switch immediately."
→ One-sided, loses credibilityComparison Table Best Practices
| Element | Do | Don't |
|---|---|---|
| Features | Include genuine differentiators | Pad with irrelevant features you win |
| Ratings | Use checkmarks, not scores | Make up arbitrary scores |
| Honesty | Show where competitor wins | Hide their strengths |
| Specificity | "Unlimited" vs "10 per month" | "Good" vs "Bad" |
| Freshness | Date the comparison, keep updated | Let it get stale |
Good Comparison Table
✓ Feature Acme Notion
───────────────────────────────────────────────
Real-time collaboration ✓ ✓
Unlimited storage ✓ ✓ (paid)
API access ✓ ✓
Offline mode ✓ Limited
Custom integrations 50+ 200+
Starting price Free Free
Speed/Performance Very fast Moderate
Learning curve Low Moderate
Mobile app Native NativeBad Comparison Table
✗ Feature Acme Competitor
───────────────────────────────────────────────
Quality Excellent Poor
Value Great Bad
Support Amazing Terrible
Innovation 10/10 2/10
→ Subjective, biased, lacks specificsAdvantage Sections
Structure each advantage as: 1. Clear benefit headline 2. Why it matters (1-2 sentences) 3. Specific evidence (metric, quote, or example)
✓ "Ship 3x faster with native Git integration"
Acme syncs directly with your repos. No manual updates, no context
switching. Every change is tracked automatically.
"We cut our deploy time from 45 minutes to 12 minutes after
switching from Notion." — VP Engineering, TechCorp"When to Choose [Competitor]" Section
This counterintuitive section builds trust:
✓ "When Notion might be better for you:
• You need a wiki + project management in one tool
• Your team is primarily non-technical
• You want maximum customization flexibility
• You're already deeply embedded in Notion's ecosystem
We're not the right fit for everyone, and that's okay. If these
describe you, Notion might serve you better."Why This Works
| Approach | Effect |
|---|---|
| Acknowledging competitor strengths | Builds trust, shows confidence |
| Helping people self-select out | Reduces churn, improves fit |
| Being honest | Differentiates from biased competitors |
| Showing maturity | Signals professionalism |
Switching Story Format
┌────────────────────────────────────────────────────┐
│ CUSTOMER SWITCHING STORY │
│ │
│ "[Company] switched from [Competitor] to [You]" │
│ │
│ • Why they switched │
│ • How the migration went │
│ • Results after switching │
│ • Quote from champion │
└────────────────────────────────────────────────────┘Good Switching Story
✓ "How Linear's engineering team switched from Jira"
"We loved Jira's power, but it was slowing us down. Every sprint
planning took hours. After switching to Acme, we cut planning time
by 60% and actually started enjoying standups."
Migration time: 1 week for 50-person team
Data imported: 100% (projects, issues, history)
Result: 60% faster sprint planning
— Marcus Chen, Engineering Manager, LinearMigration Support Section
| Element | Example |
|---|---|
| Import tools | "One-click import from [Competitor]" |
| Data migration | "We'll migrate your data for free" |
| Time estimate | "Most teams are up and running in 2 hours" |
| Support offer | "Our team will help you switch" |
| Risk reduction | "Keep your [Competitor] account during transition" |
Good Migration Copy
✓ "Switching is easier than you think"
1. Export your data from Notion (we'll show you how)
2. Import with one click — everything comes over
3. Invite your team — they'll feel at home immediately
Average migration time: 47 minutes
Data loss: None. Ever.
Need help? Our team has migrated 500+ companies from Notion.
[Book a free migration call]Comparison Page CTAs
| Intent Level | Primary CTA | Supporting CTA |
|---|---|---|
| High intent | "Start free trial" | "See how to switch" |
| Comparing | "Try Acme free" | "See full comparison" |
| Early research | "See Acme in action" | "Read customer stories" |
SEO Considerations
| Element | Best Practice |
|---|---|
| Title tag | "[You] vs [Competitor] (2024 Comparison)" |
| Meta description | "Compare [You] and [Competitor]. See features, pricing, and differences..." |
| H1 | "[You] vs [Competitor]" or "Best [Competitor] Alternatives" |
| URL | /vs/[competitor] or /alternatives/[competitor] |
| Freshness | Update quarterly with latest info |
Comparison Page Checklist
- [ ] Headline matches search intent
- [ ] TL;DR gives honest summary
- [ ] Comparison table is fair and specific
- [ ] Advantages are backed by evidence
- [ ] Competitor strengths are acknowledged
- [ ] Switching story from real customer
- [ ] Migration support is clearly explained
- [ ] Page is dated and kept current
- [ ] CTA matches visitor intent
- [ ] SEO elements optimized
Anti-Patterns
- Bashing competitors — Attacking feels desperate and loses trust
- Inflating your wins — Exaggeration backfires when people try the product
- Ignoring their strengths — One-sided comparisons aren't credible
- Outdated information — Using old competitor info is misleading
- Missing migration path — "Switch" without "how" creates friction
- No real customer stories — Generic claims don't convince
- Invisible updates — Date your comparisons, update regularly
- Aggressive tone — Confident beats combative
- Feature-only comparison — Include pricing, support, ecosystem
- No self-disqualification — Help wrong-fit prospects leave
Demo Request and Contact Pages
Impact: CRITICAL
Demo and contact pages are conversion endpoints. Every word either reduces friction or adds it. These pages should make taking action feel easy, valuable, and low-risk.
Types of Conversion Pages
| Page Type | Purpose | Target Visitor |
|---|---|---|
| Demo request | Book a call with sales | Qualified, ready to evaluate |
| Contact sales | Start a sales conversation | Enterprise, complex needs |
| Get started | Begin self-serve signup | Ready to try |
| Talk to us | General inquiry | Various intent levels |
| Get a quote | Custom pricing | Enterprise buyers |
Demo Request Page Structure
┌────────────────────────────────────────────────────┐
│ 1. HEADLINE │
│ Value-focused, not "Request a Demo" │
│ What they'll get from the call │
├────────────────────────────────────────────────────┤
│ 2. VALUE PROPOSITION │
│ Why the demo is worth their time │
│ 2-4 bullets on what they'll see/learn │
├────────────────────────────────────────────────────┤
│ 3. FORM │
│ Essential fields only │
│ Clear submit button │
├────────────────────────────────────────────────────┤
│ 4. SOCIAL PROOF │
│ Logos or testimonial │
│ "Join 1,000+ companies" │
├────────────────────────────────────────────────────┤
│ 5. FAQ / OBJECTION HANDLING │
│ "What happens next?" │
│ Time commitment, no-pressure │
├────────────────────────────────────────────────────┤
│ 6. ALTERNATIVE OPTION │
│ "Prefer to explore on your own?" │
│ Link to self-serve or resources │
└────────────────────────────────────────────────────┘Demo Page Headlines
| Formula | Example | Tone |
|---|---|---|
| See [Product] in action | "See Acme in action" | Direct |
| Get a personalized demo | "Get a personalized walkthrough" | White-glove |
| [Outcome] in [Time] | "See how to ship 3x faster in 30 minutes" | Value-focused |
| Let us show you | "Let us show you what's possible" | Consultative |
Good Demo Headlines
✓ "See how Acme can help your team ship faster"
→ Outcome-focused, personalized
✓ "Get a personalized demo in 30 minutes"
→ Clear time commitment
✓ "Let's find the right solution for your team"
→ Consultative, not pushy
✓ "Your questions, answered live"
→ Addresses the value of human interactionBad Demo Headlines
✗ "Request a Demo"
→ Zero value proposition
✗ "Contact Us"
→ Generic, cold
✗ "Fill Out This Form to Get Started"
→ Focuses on the task, not the value
✗ "Schedule Your Personalized AI-Powered Demo Experience"
→ Over-engineered, buzzwordyValue Proposition for Demos
Tell them what they'll get:
✓ "In your 30-minute demo, you'll:"
• See Acme configured for your use case
• Get answers to your specific questions
• Learn about pricing and implementation
• Receive a custom proposal (if you want one)
✓ "What to expect:"
• A quick needs assessment (5 min)
• A personalized walkthrough (20 min)
• Q&A and next steps (5 min)
• No pressure, no hard sellBad Value Propositions
✗ "Request a demo today!"
→ No information about what they get
✗ "Our team will reach out to discuss your needs"
→ Vague, feels like entering a sales funnel
✗ "Fill out the form to begin your journey with us"
→ Corporate speak, no specificsForm Field Strategy
| Field | Essential? | Why Include |
|---|---|---|
| Yes | Primary contact | |
| First name | Yes | Personalization |
| Last name | Often | Professional setting |
| Company | Often | Qualification |
| Company size | Sometimes | Routing/qualification |
| Phone | Sometimes | Follow-up option |
| Role/title | Sometimes | Personalization |
| Message | Rarely | Let them share context |
Optimal Form Length
| Context | Recommended Fields | Conversion Impact |
|---|---|---|
| High volume | 2-3 fields | Maximum submissions |
| Qualified leads | 4-5 fields | Better quality |
| Enterprise | 5-7 fields | Appropriate friction |
| Simple contact | 2-3 fields | Maximize response |
Good Form Design
✓ First name [_____________]
Work email [_____________]
Company [_____________]
Company size [Dropdown: 1-10, 11-50, 51-200, 200+]
[ Book my demo ]
We'll respond within 24 hoursBad Form Design
✗ 15 fields including:
- Fax number
- How did you hear about us (required)
- Describe your challenges in detail (required)
- Budget range (required)
- Timeline (required)
→ Too much friction, feels like an interrogationSubmit Button Copy
| Generic (Avoid) | Specific (Better) |
|---|---|
| "Submit" | "Book my demo" |
| "Send" | "Get in touch" |
| "Contact" | "Request a callback" |
| "Next" | "Schedule a time" |
Good Submit Buttons
✓ "Book my demo"
✓ "Request my personalized demo"
✓ "Talk to our team"
✓ "Get my custom quote"
✓ "Start the conversation"Social Proof Placement
| Location | Type | Purpose |
|---|---|---|
| Near form | Logo bar | Trust building |
| Below headline | Single stat | Social validation |
| Beside form | Testimonial | Reduce anxiety |
| Footer area | Trust badges | Security assurance |
Good Social Proof
✓ "Join 2,000+ teams who've made the switch"
[Stripe logo] [Figma logo] [Linear logo]
✓ "★★★★★ 4.9/5 on G2 (500+ reviews)"
✓ "Trusted by teams at companies you know"
[Logo bar of recognizable brands]
✓ Quote: "The best decision we made this year."
— VP Engineering, Series B StartupObjection Handling Section
Address common hesitations:
| Objection | Response |
|---|---|
| "Will I get spammed?" | "No spam, just one follow-up email" |
| "How long will this take?" | "30 minutes, you can end early anytime" |
| "Is this a sales pitch?" | "It's a conversation, not a pitch" |
| "What if I'm not ready to buy?" | "Most people book demos to learn, not buy" |
Good FAQ Section
✓ "What happens after I submit?"
We'll email you within 24 hours to schedule a time that works.
If you don't see our email, check spam (and mark us safe!).
✓ "What if I'm just exploring?"
That's totally fine. Most demos are exploratory.
No pressure to make any decisions.
✓ "Can I bring my team?"
Absolutely. Invite anyone who'd find the demo useful.Alternative Path Section
Always offer an alternative for those not ready:
✓ "Not ready for a call?"
• Watch a 5-minute product tour
• Explore our documentation
• Start a free trial
✓ "Prefer to self-serve?"
[Start free trial — no credit card required]Contact Page vs Demo Page
| Element | Demo Page | Contact Page |
|---|---|---|
| Purpose | Book a call | General inquiry |
| Form length | 4-6 fields | 2-4 fields |
| Expectation | Meeting scheduled | Response received |
| CTA | "Book demo" | "Send message" |
| Response time | 24 hours to schedule | 1-2 business days |
Contact Page Structure
┌────────────────────────────────────────────────────┐
│ 1. HEADLINE │
│ "Let's talk" or "Questions? We're here" │
├────────────────────────────────────────────────────┤
│ 2. CONTACT OPTIONS │
│ Form + email + phone (if applicable) │
├────────────────────────────────────────────────────┤
│ 3. SIMPLE FORM │
│ Name, email, message │
├────────────────────────────────────────────────────┤
│ 4. RESPONSE EXPECTATION │
│ "We typically respond within..." │
├────────────────────────────────────────────────────┤
│ 5. ALTERNATIVE RESOURCES │
│ Help docs, FAQ, community │
└────────────────────────────────────────────────────┘Good Contact Page Copy
✓ "Get in touch"
Have a question? Want to learn more? Just want to say hi?
We'd love to hear from you.
[Simple form: Name, Email, Message]
We typically respond within 1 business day.
Looking for support? Visit our help center.
Want a demo? Book a time with our team.Post-Submission Experience
| Element | Best Practice |
|---|---|
| Confirmation message | "Thanks! We'll be in touch within 24 hours" |
| Next steps | "Check your email for confirmation" |
| While you wait | "Explore our resources" / "See product tour" |
| Confirmation email | Immediate, with calendar link or next steps |
Conversion Page Checklist
- [ ] Headline communicates value, not just action
- [ ] Form asks only essential questions
- [ ] Submit button is specific and action-oriented
- [ ] Social proof visible near form
- [ ] Response time expectation set
- [ ] Objections addressed (FAQ or inline)
- [ ] Alternative path for non-ready visitors
- [ ] Mobile-optimized form and CTA
- [ ] Confirmation message/page after submission
- [ ] Follow-up email automated
Anti-Patterns
- "Submit" buttons — Use specific, value-oriented copy
- Too many fields — Every field costs conversions
- No response expectation — People wonder if it worked
- Missing social proof — Trust is crucial at conversion
- Buried form — Above fold, easy to find
- No alternative — Offer options for different readiness
- Generic headline — "Contact Us" is a missed opportunity
- Required phone — Many people won't give phone numbers
- CAPTCHA friction — Use invisible alternatives if possible
- No mobile optimization — Thumb-friendly fields and buttons
Feature Page Copy
Impact: CRITICAL
Feature pages bridge the gap between "this sounds interesting" and "I can see myself using this." They demonstrate capability while selling outcomes.
Feature Page Structure
┌────────────────────────────────────────────────────┐
│ 1. FEATURE HERO │
│ Benefit headline + Capability subhead │
│ Screenshot/video + CTA │
├────────────────────────────────────────────────────┤
│ 2. PROBLEM STATEMENT │
│ The pain this feature solves │
│ (Optional: "Before [Product]...") │
├────────────────────────────────────────────────────┤
│ 3. KEY BENEFITS (3-5) │
│ Outcome-focused, not feature-focused │
│ Each with supporting detail │
├────────────────────────────────────────────────────┤
│ 4. HOW IT WORKS │
│ Visual walkthrough or steps │
│ Screenshots with captions │
├────────────────────────────────────────────────────┤
│ 5. DETAILED CAPABILITIES │
│ Expandable or tabbed feature list │
│ Technical details for evaluators │
├────────────────────────────────────────────────────┤
│ 6. USE CASES │
│ 2-3 specific scenarios │
│ "Perfect for..." format │
├────────────────────────────────────────────────────┤
│ 7. SOCIAL PROOF │
│ Testimonial specific to this feature │
│ Metric if available │
├────────────────────────────────────────────────────┤
│ 8. RELATED FEATURES │
│ Cross-link to complementary features │
├────────────────────────────────────────────────────┤
│ 9. CTA SECTION │
│ "Try [Feature]" or "See [Feature] in action" │
└────────────────────────────────────────────────────┘The Benefit-First Principle
Always lead with the outcome, then explain the mechanism:
| Pattern | Example |
|---|---|
| Benefit → Feature | "Ship faster with automated testing" |
| Feature → Benefit | "Our automated testing helps you ship faster" |
| Benefit only | "Ship 3x faster" |
Feature Headline Formulas
| Formula | Example | Best For |
|---|---|---|
| [Outcome] with [Feature] | "Never miss a bug with automated testing" | Outcome clarity |
| [Feature]: [Benefit] | "Smart Alerts: Know before your customers do" | Feature recognition |
| [Verb] your [Noun], [Qualifier] | "Track your metrics, in real-time" | Action-oriented |
| [Pain Point] solved | "Context switching, solved" | Problem-aware visitors |
| The [Noun] that [Differentiator] | "The dashboard that updates itself" | Competitive diff |
Good Feature Headlines
✓ "Reporting that writes itself"
→ Outcome-focused, implies ease
✓ "Real-time collaboration without the chaos"
→ Benefit + addresses concern
✓ "Find any file in milliseconds"
→ Specific, measurable outcome
✓ "Integrations that just work"
→ Addresses integration pain
✓ "Automated workflows: Set it and forget it"
→ Feature name + benefit summaryBad Feature Headlines
✗ "Reporting"
→ Zero value proposition
✗ "Advanced Analytics Dashboard v2.0"
→ Technical naming, no benefit
✗ "Powerful Collaboration Tools"
→ Generic, could be any product
✗ "Our Best Feature Yet"
→ Self-congratulatory, no information
✗ "Next-Gen Automation Engine"
→ Buzzwords without substanceWriting Benefit Statements
Transform features into benefits using this structure:
| Feature | So What? | Benefit Statement |
|---|---|---|
| "99.9% uptime" | Users don't experience downtime | "Always available when you need it" |
| "256-bit encryption" | Data is secure | "Your data stays yours" |
| "Real-time sync" | Changes appear instantly | "See updates the moment they happen" |
| "30+ integrations" | Works with existing tools | "Connect your entire stack" |
| "Customizable dashboards" | See what matters to you | "Your data, your way" |
Good Benefit Sections
✓ "Get answers in seconds, not hours"
Your team stops waiting. With instant search across all your documents,
the information you need is always one query away.
✓ "Never lose a conversation again"
Every message, every thread, every decision — automatically saved and
searchable. No more "Can you resend that?"
✓ "Scale without scaling your team"
Automation handles the repetitive work. Handle 10x the volume with
the same headcount.Bad Benefit Sections
✗ "Powerful Search Capabilities"
Our search feature uses advanced algorithms to find your content.
→ Technical focus, no user benefit
✗ "Industry-Leading Technology"
We've invested millions in our cutting-edge infrastructure.
→ About you, not about them
✗ "Robust and Scalable"
Built on enterprise-grade architecture for maximum performance.
→ Jargon without meaningCapability vs. Benefit Matrix
| Don't Say (Capability) | Say This (Benefit) |
|---|---|
| "Custom fields" | "Track exactly what matters to you" |
| "API access" | "Build anything on top of our platform" |
| "Role-based permissions" | "Give everyone exactly the access they need" |
| "Audit logs" | "Know who did what, and when" |
| "SSO support" | "One login for your whole team" |
| "Webhooks" | "Get notified the moment things happen" |
| "Bulk actions" | "Update hundreds of records in seconds" |
| "Version history" | "Undo anything, recover everything" |
How It Works Section
Use 3-5 steps maximum. Each step should be:
- Titled with an action verb
- Described in one sentence
- Accompanied by a visual
✓ Good "How It Works":
1. Connect your tools
Link your existing apps in one click. We support 50+ integrations.
[Screenshot of integration setup]
2. Set your rules
Define what triggers automation and what happens next.
[Screenshot of rule builder]
3. Watch it work
Sit back as repetitive tasks handle themselves.
[Screenshot of automation running]✗ Bad "How It Works":
1. First, create an account and verify your email
2. Then navigate to settings and configure your preferences
3. Next, set up your first project by clicking the + button
4. After that, invite your team members
5. Now you can start using the platform
6. Don't forget to check out our documentation
→ Too many steps, too much detail, no visualsUse Case Formatting
✓ "Perfect for product teams who..."
• Need to track feature requests across channels
• Want to prioritize based on customer impact
• Hate switching between tools
✓ "Built for engineering teams that..."
• Deploy multiple times per day
• Need visibility into what's shipping
• Want to catch issues before users doFeature Page CTAs
| Feature Type | Primary CTA | Secondary CTA |
|---|---|---|
| Core feature | "Try it free" | "See it in action" |
| Enterprise feature | "Talk to sales" | "See pricing" |
| Technical feature | "Read the docs" | "Start building" |
| New feature | "Get early access" | "Learn more" |
Social Proof for Feature Pages
| Proof Type | Example | Best For |
|---|---|---|
| Metric | "Teams save 5 hours/week with automation" | Quantifiable features |
| Quote | "Finally, reporting I actually use." — VP Engineering | Emotional features |
| Logo | "Used by teams at Stripe, Notion, Figma" | Trust features |
| Case study link | "How Acme reduced QA time by 60%" | Complex features |
Feature Page Checklist
- [ ] Headline leads with benefit, not feature name
- [ ] Subheadline explains the "how" or adds specificity
- [ ] Hero visual shows the feature in action
- [ ] 3-5 key benefits with supporting detail
- [ ] "How it works" in 3-5 clear steps
- [ ] At least one testimonial or proof point
- [ ] CTA specific to this feature
- [ ] Cross-links to related features
- [ ] Mobile-optimized visuals and layout
Anti-Patterns
- Listing features without benefits — "We have X" vs "You get Y"
- Technical jargon — Write for users, not engineers
- Generic screenshots — Show the feature in realistic use
- Missing "so what" — Every capability needs an outcome
- Wall of text — Scannable beats readable
- No proof points — Claims need evidence
- Weak CTA — "Learn more" is not a feature CTA
- Feature isolation — Show how it connects to other features
Homepage Messaging Hierarchy
Impact: CRITICAL
Your homepage has 3-5 seconds to answer: "What is this, and is it for me?" The messaging hierarchy determines whether visitors explore or bounce.
The Hero Section Formula
| Element | Purpose | Character Limit |
|---|---|---|
| Headline | What you do + for whom | 6-12 words |
| Subheadline | How you do it + key benefit | 15-25 words |
| Primary CTA | Main desired action | 2-5 words |
| Secondary CTA | Lower-commitment option | 2-5 words |
| Social proof | Immediate credibility | Logos or single stat |
Homepage Section Order
┌────────────────────────────────────────────────────┐
│ 1. HERO │
│ Headline + Subhead + CTA + Social Proof │
│ (Answer: What is this?) │
├────────────────────────────────────────────────────┤
│ 2. LOGO BAR │
│ 5-8 customer logos │
│ (Answer: Who else uses this?) │
├────────────────────────────────────────────────────┤
│ 3. PROBLEM/SOLUTION │
│ Pain point → Your approach │
│ (Answer: Do they understand my problem?) │
├────────────────────────────────────────────────────┤
│ 4. KEY FEATURES │
│ 3-4 primary capabilities with benefits │
│ (Answer: What can I do with this?) │
├────────────────────────────────────────────────────┤
│ 5. HOW IT WORKS │
│ 3-step process or visual demo │
│ (Answer: Is this easy to use?) │
├────────────────────────────────────────────────────┤
│ 6. SOCIAL PROOF DEEP │
│ Testimonials, case studies, metrics │
│ (Answer: Does this actually work?) │
├────────────────────────────────────────────────────┤
│ 7. SECONDARY FEATURES │
│ Additional capabilities, integrations │
│ (Answer: What else can it do?) │
├────────────────────────────────────────────────────┤
│ 8. FINAL CTA │
│ Repeated hero CTA with urgency/incentive │
│ (Answer: What should I do now?) │
└────────────────────────────────────────────────────┘Headline Formulas That Work
| Formula | Example | Best For |
|---|---|---|
| [Outcome] for [Audience] | "Faster deploys for engineering teams" | Clear audience |
| [Verb] your [Noun] | "Automate your infrastructure" | Action-oriented |
| The [Category] that [Differentiator] | "The CRM that sells itself" | Competitive markets |
| [Pain Point] is over | "Manual QA is over" | Problem-aware audiences |
| [Number] [Benefit] | "10x faster code reviews" | Quantifiable outcomes |
| Stop [Pain], Start [Gain] | "Stop chasing leads, start closing deals" | Transformation |
Good Homepage Headlines
✓ "Ship code without breaking things"
→ Clear outcome, implies audience (developers)
✓ "Customer support that scales with you"
→ Benefit + addresses growth concern
✓ "Turn customer feedback into product roadmap"
→ Input → Output transformation
✓ "The analytics platform built for product teams"
→ Category + specific audience
✓ "Contracts signed in minutes, not weeks"
→ Before/after with specificityBad Homepage Headlines
✗ "Welcome to Acme Inc."
→ Zero information about what you do
✗ "Next-Generation Enterprise Solutions"
→ Meaningless buzzwords
✗ "We're changing the way teams work"
→ Vague, self-focused
✗ "The Future of [Industry]"
→ Grandiose, unsubstantiated
✗ "Powerful. Simple. Fast."
→ Adjectives without contextSubheadline Best Practices
The subheadline expands on the headline with specificity:
| If headline is... | Subheadline should... |
|---|---|
| Outcome-focused | Explain the mechanism |
| Audience-focused | State the benefit |
| Problem-focused | Introduce the solution |
| Bold claim | Provide proof or context |
Good Subheadlines
Headline: "Ship code without breaking things"
✓ Subhead: "Automated testing that catches bugs before your customers do.
Set up in 5 minutes, integrates with your CI/CD pipeline."
→ Explains how, adds speed + ease proof
Headline: "Customer support that scales with you"
✓ Subhead: "AI-powered ticketing that resolves 40% of requests automatically
while keeping your human touch."
→ Mechanism + specific metric + addresses concernBad Subheadlines
✗ "We're on a mission to help teams succeed"
→ Vague, doesn't expand on headline
✗ "Learn more about our innovative platform"
→ Says nothing, wastes prime real estate
✗ "Trusted by thousands of companies worldwide"
→ Better as social proof, not subheadCTA Hierarchy
| CTA Type | Examples | When to Use |
|---|---|---|
| High commitment | "Start free trial", "Buy now" | Product-aware visitors |
| Medium commitment | "See demo", "Get a quote" | Solution-aware visitors |
| Low commitment | "See how it works", "Explore features" | Problem-aware visitors |
Good CTA Combinations
✓ Primary: "Start free trial"
Secondary: "See it in action"
→ Clear path for ready + curious visitors
✓ Primary: "Get started free"
Secondary: "Talk to sales"
→ Self-serve + enterprise paths
✓ Primary: "Book a demo"
Secondary: "Watch 2-min overview"
→ Qualified path + quick previewBad CTA Combinations
✗ Primary: "Learn more"
Secondary: "Contact us"
→ Both vague, no clear hierarchy
✗ Primary: "Start trial"
Secondary: "Start trial"
→ No alternative path
✗ Three equal CTAs
→ Choice paralysis, no clear directionSocial Proof Placement
| Location | Type | Impact |
|---|---|---|
| Hero (below CTA) | Logo bar or single stat | Immediate credibility |
| After problem/solution | Testimonial quote | Validates the pain |
| After features | Case study snippet | Proves capabilities |
| Before final CTA | Multiple testimonials | Overcomes last objections |
Above-the-Fold Checklist
- [ ] Headline answers "What is this?"
- [ ] Subheadline explains the "how" or "why"
- [ ] Primary CTA is specific and action-oriented
- [ ] Secondary CTA offers alternative path
- [ ] Social proof element visible (logos or stat)
- [ ] No competing navigation distractions
- [ ] Mobile: CTA visible without scrolling
Homepage Metrics to Track
| Metric | Target | What It Measures |
|---|---|---|
| Bounce rate | <50% | Messaging relevance |
| Scroll depth | >60% to CTA | Content engagement |
| CTA click rate | >5% | Value prop clarity |
| Time on page | 1-3 min | Content quality |
Anti-Patterns
- "We" focus — Homepage is about the visitor, not you
- Feature list as hero — Lead with outcomes, not capabilities
- Jargon in headlines — "AI-powered synergistic solutions" means nothing
- No clear CTA — Every homepage needs one primary action
- Competing messages — One value prop, not five
- Buried differentiation — If you're different, say it above the fold
- Missing social proof — Claims without credibility
- Navigation overload — Too many choices = no choice
Integration Pages
Impact: MEDIUM-HIGH
Integration pages capture high-intent searches like "[Your Product] + [Tool]" and prove your product fits their existing workflow. They're SEO goldmines and trust builders.
Integration Page Types
| Type | URL Pattern | Purpose |
|---|---|---|
| Hub page | /integrations | Overview of all integrations |
| Category page | /integrations/[category] | Group by type (CRM, DevOps) |
| Single integration | /integrations/[tool] | Deep dive on one tool |
| Native feature | /features/[tool]-integration | Built-in vs add-on |
Integration Hub Structure
┌────────────────────────────────────────────────────┐
│ 1. HERO │
│ "Connect [Product] to your favorite tools" │
│ Number of integrations + search bar │
├────────────────────────────────────────────────────┤
│ 2. FEATURED INTEGRATIONS │
│ Most popular or requested (6-12) │
│ Logos with quick descriptions │
├────────────────────────────────────────────────────┤
│ 3. CATEGORY SECTIONS │
│ Grouped by use case or tool type │
│ Expandable or filterable list │
├────────────────────────────────────────────────────┤
│ 4. API/BUILD YOUR OWN │
│ Developer resources for custom integrations │
├────────────────────────────────────────────────────┤
│ 5. REQUEST INTEGRATION │
│ Form or link to request new integrations │
├────────────────────────────────────────────────────┤
│ 6. CTA │
│ "Start free and connect your tools" │
└────────────────────────────────────────────────────┘Single Integration Page Structure
┌────────────────────────────────────────────────────┐
│ 1. HERO │
│ "[Product] + [Tool]" with both logos │
│ One-line value prop │
├────────────────────────────────────────────────────┤
│ 2. KEY BENEFITS │
│ What this integration enables (3-5) │
│ Specific to this combination │
├────────────────────────────────────────────────────┤
│ 3. HOW IT WORKS │
│ Setup process (usually 3 steps) │
│ What syncs, triggers, actions │
├────────────────────────────────────────────────────┤
│ 4. USE CASES │
│ 2-3 specific scenarios │
│ "Perfect for teams who..." │
├────────────────────────────────────────────────────┤
│ 5. TECHNICAL DETAILS │
│ Data sync, permissions, security │
│ For evaluators doing due diligence │
├────────────────────────────────────────────────────┤
│ 6. TESTIMONIAL │
│ Customer using this specific integration │
├────────────────────────────────────────────────────┤
│ 7. RELATED INTEGRATIONS │
│ Other tools in same category │
├────────────────────────────────────────────────────┤
│ 8. CTA │
│ "Connect [Tool] now" or "Start free trial" │
└────────────────────────────────────────────────────┘Integration Page Headlines
| Formula | Example | Best For |
|---|---|---|
| [Product] + [Tool] | "Acme + Slack" | SEO, clarity |
| Connect [Product] to [Tool] | "Connect Acme to Salesforce" | Action-oriented |
| [Product] [Tool] Integration | "Acme Slack Integration" | Search-optimized |
| [Benefit] with [Tool] | "Get notified in Slack" | Benefit-led |
Good Integration Headlines
✓ "Acme + GitHub: Code changes, automatically tracked"
→ Both products + specific value
✓ "Bring Acme into Slack"
→ Action-oriented, tool-first
✓ "Sync your CRM with Acme"
→ Category approach for hub pages
✓ "Two-way sync with Salesforce"
→ Technical specificityBad Integration Headlines
✗ "Integration"
→ Zero information
✗ "Our Slack Solution"
→ Vague, generic
✗ "Powerful Third-Party Connectivity"
→ Jargon, no specificity
✗ "Integrations Page"
→ Wasted headline opportunityWriting Integration Benefits
Focus on what becomes possible, not what's connected:
| Integration | Don't Say | Say This |
|---|---|---|
| Slack | "Sends data to Slack" | "Get alerts where you already work" |
| Salesforce | "Syncs with CRM" | "See customer context without switching tabs" |
| GitHub | "Connects to repositories" | "Link code changes to project tasks" |
| Zapier | "Works with Zapier" | "Connect to 5,000+ apps without code" |
Good Integration Benefits
✓ "Acme + Slack"
• Get notified instantly
New comments, assignments, and updates appear in your Slack
channels automatically.
• Reply without leaving Slack
Respond to comments, update statuses, and assign tasks
directly from Slack.
• Keep everyone in the loop
Weekly digests and real-time alerts keep your team aligned.Bad Integration Benefits
✗ "Acme + Slack"
• Slack integration
• Real-time notifications
• Data synchronization
• Bi-directional communication
→ Feature list without user valueHow It Works Section
Keep it to 3 steps maximum:
✓ "How to connect Acme and Slack"
1. Click "Connect to Slack" in your Acme settings
Authorize Acme to access your Slack workspace.
2. Choose your channels
Select which Slack channels receive Acme updates.
3. You're connected
Updates flow automatically. Customize in settings anytime.
Setup time: Under 2 minutes
Permissions required: Read/write to selected channelsTechnical Details Section
| Element | What to Include |
|---|---|
| Sync frequency | Real-time, hourly, daily |
| Data flow | One-way or bi-directional |
| What syncs | Specific objects/data types |
| Permissions | What access is needed |
| Security | How data is protected |
| Limitations | Any known constraints |
Good Technical Details
✓ "Technical Details"
Sync type: Real-time, bi-directional
Data synced: Projects, tasks, comments, attachments
Permissions: Read/write access to selected channels
Security: OAuth 2.0, data encrypted in transit
Rate limits: 10,000 API calls per hour
Requirements: Slack Business plan or higherUse Cases for Integration Pages
✓ "Perfect for teams who..."
• Track GitHub issues alongside product tasks
• Want developers notified without leaving their IDE
• Need deployment events linked to project milestones
✓ "Common workflows"
• When a PR is merged → Task marked complete
• When a bug is filed → Slack alert + task created
• When a release ships → Stakeholders notifiedIntegration Page CTAs
| Context | Primary CTA | Secondary CTA |
|---|---|---|
| Has account | "Connect [Tool]" | "View setup guide" |
| No account | "Start free trial" | "See how it works" |
| Enterprise tool | "Talk to sales" | "Read documentation" |
Good Integration CTAs
✓ "Already have an Acme account?"
[Connect Slack now]
✓ "New to Acme?"
[Start free trial — connect Slack in minutes]
✓ For enterprise integrations:
[Contact sales for Salesforce Enterprise setup]Category Organization
| Category | Example Tools |
|---|---|
| Communication | Slack, Teams, Discord |
| CRM | Salesforce, HubSpot, Pipedrive |
| DevOps | GitHub, GitLab, Bitbucket |
| Project Management | Jira, Asana, Monday |
| Marketing | Marketo, Mailchimp, Intercom |
| Storage | Google Drive, Dropbox, OneDrive |
| Analytics | Segment, Amplitude, Mixpanel |
Integration Hub Categories
✓ "DevOps & Engineering"
Connect your development workflow
GitHub • GitLab • Bitbucket • Jenkins • CircleCI
[See all DevOps integrations →]
✓ "Communication"
Stay informed where you work
Slack • Microsoft Teams • Discord • Email
[See all communication integrations →]SEO Optimization
| Element | Best Practice |
|---|---|
| Title | "[Your Product] [Tool] Integration" |
| Meta | "Connect [Your Product] with [Tool]. Sync [data types], automate workflows..." |
| H1 | "[Your Product] + [Tool]" |
| URL | /integrations/[tool-name] |
| Alt text | "[Your Product] and [Tool] logos" |
Integration Page Checklist
- [ ] Headline uses both product names
- [ ] Logos for both products displayed
- [ ] Benefits are integration-specific, not generic
- [ ] Setup steps are clear and numbered
- [ ] Technical details for evaluators
- [ ] Testimonial from user of this integration
- [ ] Related integrations cross-linked
- [ ] CTA matches user's likely account status
- [ ] SEO elements optimized
- [ ] Page stays updated when integration changes
Anti-Patterns
- Generic benefits — "Sync your data" means nothing
- Missing logos — Visual recognition matters
- No setup info — How hard is it to connect?
- Technical-only — Balance tech details with user value
- Outdated pages — Old screenshots, deprecated features
- No use cases — Show what becomes possible
- Isolated pages — Cross-link related integrations
- Missing requirements — What plan/version is needed?
- No testimonials — Integration-specific proof helps
- Buried in navigation — Make integrations easy to find
Navigation and Microcopy
Impact: MEDIUM
Microcopy is the small text that guides users through your site — navigation labels, button text, form hints, error messages, and empty states. It's invisible when done well and frustrating when done poorly.
Types of Microcopy
| Type | Examples | Purpose |
|---|---|---|
| Navigation | Menu labels, breadcrumbs | Wayfinding |
| Buttons | CTAs, form submits | Action guidance |
| Form labels | Field names, hints, errors | Input assistance |
| Empty states | No results, first-use | Reduce confusion |
| Tooltips | Hover explanations | Contextual help |
| Confirmation | Success messages | Closure and next steps |
| Loading/Progress | Processing messages | Patience and trust |
Navigation Label Principles
| Principle | Example |
|---|---|
| Clarity over cleverness | "Pricing" not "Investment" |
| Nouns for destinations | "Features" not "Explore Features" |
| Consistency | Same word, same meaning |
| Parallel structure | "Products", "Pricing", "Resources" |
| User mental models | Use expected terms |
Good Navigation Labels
✓ Main navigation:
Product | Pricing | Customers | Resources | Company
✓ Footer navigation:
Product: Features, Integrations, Security, Changelog
Company: About, Careers, Press, Contact
Resources: Blog, Help Center, API Docs, Status
✓ Dropdown menu:
Resources
├── Blog
├── Help Center
├── API Documentation
├── Community
└── What's NewBad Navigation Labels
✗ "Discover" (discover what?)
✗ "Solutions" without context (too vague)
✗ "Hub" (hub of what?)
✗ "Explore Our Offerings" (too wordy)
✗ "Innovation Center" (corporate speak)
✗ "Start Your Journey" (for a nav item)Navigation Structure Patterns
| Pattern | When to Use | Example |
|---|---|---|
| Simple | Few pages, clear product | Product, Pricing, Docs |
| Audience-based | Multiple personas | For Engineers, For Teams |
| Product-based | Multiple products | Platform, Apps, Enterprise |
| Use case-based | Solution selling | Use Cases, Industries |
Good Navigation Hierarchies
✓ Simple SaaS:
[Logo] Product • Pricing • Docs • Blog [Login] [Sign Up]
✓ Platform company:
[Logo] Products ▾ • Solutions ▾ • Resources ▾ • Pricing [Login] [Get Started]
✓ Enterprise:
[Logo] Platform • Solutions • Customers • Resources • Company [Contact Sales]Button Copy Principles
| Principle | Bad | Good |
|---|---|---|
| Be specific | "Submit" | "Send message" |
| Lead with verb | "Your trial" | "Start trial" |
| Match expectation | "Go" | "Search" |
| Show value | "Next" | "See results" |
| Reduce anxiety | "Buy now" | "Start free trial" |
Button Copy by Action
| Action | Generic (Avoid) | Specific (Better) |
|---|---|---|
| Sign up | "Submit" | "Create account" |
| Start trial | "Start" | "Start 14-day trial" |
| Demo | "Contact" | "Book a demo" |
| Download | "Get it" | "Download PDF" |
| Subscribe | "Submit" | "Subscribe to updates" |
| Search | "Go" | "Search docs" |
| Save | "Save" | "Save changes" |
| Delete | "Delete" | "Delete project" |
Good Button Copy
✓ Primary actions:
"Start free trial"
"Get started — it's free"
"Create your account"
"Book a demo"
✓ Secondary actions:
"See how it works"
"View pricing"
"Read the docs"
"Talk to sales"
✓ Form submissions:
"Send message"
"Subscribe"
"Save changes"
"Apply filters"Bad Button Copy
✗ "Submit" (submit what?)
✗ "Click here" (obvious)
✗ "Go" (go where?)
✗ "Yes" / "No" (for complex actions)
✗ "Process" (what happens?)
✗ "Continue" (without context)Form Microcopy
| Element | Purpose | Example |
|---|---|---|
| Label | Identify the field | "Email address" |
| Placeholder | Show format | "you@company.com" |
| Hint text | Provide guidance | "We'll never share your email" |
| Error message | Explain problem + fix | "Email is required" |
| Success message | Confirm completion | "Email verified" |
Good Form Microcopy
✓ Email
[you@company.com________________]
We'll use this to send your login details
✓ Password
[••••••••••••••________________]
At least 8 characters with one number
✓ Error:
⚠ "Please enter a valid email address"
✓ Success:
✓ "Your account has been created. Check your email to verify."Bad Form Microcopy
✗ EMAIL: (all caps, unfriendly)
✗ [Enter email here] (redundant placeholder)
✗ Error: "Invalid input" (unhelpful)
✗ "Error 422: Validation failed" (technical)
✗ No hint text at all (leaves users guessing)Error Message Formula
What went wrong + How to fix it
✓ "That email is already registered. Try logging in instead."
✓ "Password must be at least 8 characters."
✓ "We couldn't process your payment. Please check your card details."
✗ "Error"
✗ "Invalid"
✗ "Something went wrong"
✗ "Please try again"Empty State Microcopy
| Scenario | What to Include |
|---|---|
| First use | What this area is for + how to start |
| No results | Why empty + what to try |
| Filtered empty | Suggest adjusting filters |
| Error state | What happened + what to do |
Good Empty States
✓ First project:
"No projects yet"
Projects help you organize your work. Create your first one
to get started.
[Create project]
✓ No search results:
"No results for 'xyz'"
Try adjusting your search or browse all items.
[Clear search] [Browse all]
✓ Empty dashboard:
"Nothing here yet"
Once your team starts using Acme, you'll see activity here.
[Invite your team]Bad Empty States
✗ "No data"
→ Unhelpful, no guidance
✗ "0 results found"
→ Technical, no next step
✗ [Blank space with no message]
→ Confusing, broken-feelingTooltip Microcopy
| Principle | Example |
|---|---|
| Brief | Under 100 characters |
| Helpful | Answers "What is this?" |
| Avoid obvious | Don't tooltip "Save" with "Saves your work" |
| Add value | Include shortcuts, tips |
Good Tooltips
✓ [?] "Daily active users who completed at least one action"
✓ [?] "Press ⌘K to open quick search"
✓ [?] "This setting affects all team members"Bad Tooltips
✗ [?] "Click this button" (obvious)
✗ [?] "This is the save button" (obvious)
✗ [?] A full paragraph of explanation (too long)Confirmation Messages
| Action | Confirmation |
|---|---|
| Save | "Changes saved" |
| Delete | "Project deleted" (with undo option) |
| Send | "Message sent" |
| Subscribe | "You're subscribed! Check your email" |
| Form submit | "Thanks! We'll be in touch within 24 hours" |
Good Confirmation Messages
✓ "Changes saved"
Brief, appears near the action
✓ "Message sent! We'll respond within 1 business day"
Confirms action + sets expectation
✓ "Project deleted" [Undo]
Acknowledges + offers recovery
✓ "Welcome to Acme! Check your email to get started"
Confirms + provides next stepLoading State Microcopy
| Duration | Message Style |
|---|---|
| < 2 seconds | Spinner only, no text |
| 2-5 seconds | "Loading..." or specific action |
| 5-10 seconds | "This might take a moment..." |
| 10+ seconds | Progress indicator + estimate |
Good Loading Messages
✓ "Generating your report..."
✓ "Syncing your data... this usually takes about 30 seconds"
✓ "Almost there..."
✓ [Progress bar] "Processing 47 of 100 items"Microcopy Voice Guidelines
| Context | Tone | Example |
|---|---|---|
| Success | Positive, brief | "You're all set!" |
| Error | Helpful, not blaming | "Hmm, that didn't work" |
| Waiting | Patient, reassuring | "Just a moment..." |
| Empty | Encouraging, guiding | "You're off to a great start" |
| Destructive | Clear, confirming | "Delete project? This can't be undone" |
Microcopy Checklist
- [ ] Navigation labels are clear nouns
- [ ] Buttons lead with verbs
- [ ] Form labels are specific
- [ ] Error messages explain how to fix
- [ ] Empty states guide users forward
- [ ] Success messages confirm and suggest next step
- [ ] Loading states set expectations
- [ ] Tooltips add value, not obvious info
- [ ] Consistent voice across all touchpoints
- [ ] Mobile-appropriate length
Anti-Patterns
- "Click here" — The action should be in the link text
- "Submit" — Always specify what's being submitted
- Technical error codes — Users don't need error 500 details
- Blaming language — "You entered an invalid email"
- Missing empty states — Blank areas feel broken
- Long loading without explanation — Users think it's frozen
- Clever over clear — Puns and jokes that confuse
- Inconsistent terminology — "Sign up" vs "Register" vs "Create account"
- All caps labels — FEELS LIKE SHOUTING
- No recovery options — Delete without undo feels dangerous
Pricing Page Copy
Impact: CRITICAL
The pricing page is where intent becomes decision. Copy here must reduce anxiety, clarify value, and make the right choice obvious. This is one of your highest-converting pages.
Pricing Page Structure
┌────────────────────────────────────────────────────┐
│ 1. HEADLINE + SUBHEAD │
│ Value-framing, not "Pricing" │
│ Set expectations for what they'll see │
├────────────────────────────────────────────────────┤
│ 2. PRICING TIERS │
│ 2-4 tiers with clear differentiation │
│ Recommended tier highlighted │
├────────────────────────────────────────────────────┤
│ 3. FEATURE COMPARISON TABLE │
│ What's included in each tier │
│ (Expandable for detailed view) │
├────────────────────────────────────────────────────┤
│ 4. FAQ SECTION │
│ Common pricing questions │
│ Objection handling │
├────────────────────────────────────────────────────┤
│ 5. SOCIAL PROOF │
│ Testimonials about value/ROI │
│ Customer logos │
├────────────────────────────────────────────────────┤
│ 6. CONTACT/ENTERPRISE CTA │
│ "Questions? Talk to us" │
│ Enterprise inquiry option │
└────────────────────────────────────────────────────┘Pricing Page Headlines
| Formula | Example | Best For |
|---|---|---|
| Simple + Clear | "Simple, transparent pricing" | Trust-focused |
| Value Framing | "Choose the plan that fits your team" | Self-serve |
| Outcome Focus | "Start shipping faster today" | Action-oriented |
| Anxiety Reduction | "No surprises. No hidden fees." | Price-sensitive |
Good Pricing Headlines
✓ "Plans that scale with you"
→ Addresses growth concern
✓ "Simple pricing. Powerful features."
→ Sets expectation of clarity + value
✓ "Start free, upgrade when you're ready"
→ Low-commitment framing
✓ "The right plan for every team"
→ Inclusive, reduces "not for me" concernBad Pricing Headlines
✗ "Pricing"
→ Missed opportunity for value framing
✗ "Our Premium Pricing Packages"
→ "Premium" sounds expensive
✗ "Investment Options for Your Business"
→ Corporate speak, feels salesy
✗ "World-Class Pricing for World-Class Results"
→ Empty hyperboleTier Naming Strategy
| Naming Approach | Examples | Best For |
|---|---|---|
| Audience-based | Starter, Team, Enterprise | Clear targeting |
| Value-based | Basic, Pro, Premium | Perceived value |
| Size-based | Solo, Small Team, Organization | Team-based pricing |
| Feature-based | Essentials, Growth, Scale | Feature-differentiated |
Good Tier Names
✓ "Free" → "Pro" → "Team" → "Enterprise"
→ Clear progression, familiar naming
✓ "Starter" → "Growth" → "Scale"
→ Journey-based, implies progression
✓ "Developer" → "Team" → "Organization"
→ Audience clarityBad Tier Names
✗ "Bronze" → "Silver" → "Gold" → "Platinum"
→ Feels like credit cards, dated
✗ "Good" → "Better" → "Best"
→ Implies lower tiers are inadequate
✗ "Basic" → "Standard" → "Advanced" → "Premium" → "Ultimate"
→ Too many tiers, unclear differentiationTier Description Copy
Each tier needs: 1. Tier name 2. Price (and billing period) 3. One-line description (who this is for) 4. Key features (3-5 differentiating features) 5. CTA button
Good Tier Descriptions
✓ "Pro — $29/month"
For growing teams that need more power.
• Unlimited projects
• Advanced analytics
• Priority support
• API access
[Start 14-day free trial]
✓ "Team — $15/user/month"
Everything you need to collaborate at scale.
• Shared workspaces
• Team permissions
• SSO included
• 99.9% uptime SLA
[Get started free]Bad Tier Descriptions
✗ "Premium Plan — $99/month"
Our best plan with all the features.
• Feature 1
• Feature 2
• Feature 3
• Feature 4
• Feature 5
• Feature 6
• Feature 7
[Buy Now]
→ No audience targeting, feature dump, no differentiation
✗ "Enterprise"
Contact us for pricing.
→ No information, no features, creates frictionHighlighting the Recommended Tier
| Method | Example | When to Use |
|---|---|---|
| Badge | "Most Popular" | Social proof approach |
| Visual emphasis | Larger card, border | Visual hierarchy |
| Value label | "Best Value" | Price-conscious audience |
| Audience label | "For Most Teams" | Audience clarity |
Writing Feature Comparisons
| Do | Don't |
|---|---|
| Use benefit language | Just list features |
| Group by category | Random order |
| Use checkmarks + X marks | Write "Yes" and "No" |
| Include limits clearly | Hide limits in footnotes |
| Make differences obvious | Make all tiers look the same |
Good Feature Table Section
✓ "Collaboration"
└─ Shared workspaces ✓ ✓ ✓
└─ Team members 5 25 Unlimited
└─ Guest access ✗ ✓ ✓
└─ SSO ✗ ✗ ✓
✓ "Support"
└─ Email support ✓ ✓ ✓
└─ Priority support ✗ ✓ ✓
└─ Dedicated CSM ✗ ✗ ✓
└─ SLA guarantee ✗ 99.9% 99.99%Pricing FAQs That Convert
| Question | Purpose |
|---|---|
| "Can I change plans later?" | Reduces commitment anxiety |
| "What happens when my trial ends?" | Clarifies next steps |
| "Do you offer discounts for annual billing?" | Encourages longer commitment |
| "Is there a free tier?" | Addresses budget concerns |
| "What payment methods do you accept?" | Reduces checkout friction |
| "Can I cancel anytime?" | Removes risk |
| "Do you offer refunds?" | Builds trust |
| "What's included in the free trial?" | Clarifies trial value |
| "Do you offer nonprofit/education discounts?" | Expands audience |
Good FAQ Answers
✓ Q: "Can I change plans later?"
A: "Absolutely. Upgrade or downgrade anytime from your dashboard.
If you upgrade, you'll be prorated for the remainder of your
billing period. If you downgrade, the change takes effect at
your next billing date."
✓ Q: "What happens when my trial ends?"
A: "We'll send you a reminder 3 days before. If you don't add a
payment method, you'll be moved to our free plan automatically.
Your data stays safe either way."Bad FAQ Answers
✗ Q: "What's your refund policy?"
A: "Please refer to our Terms of Service for detailed information
regarding our refund policy and procedures."
→ Creates friction, feels defensive
✗ Q: "Can I cancel anytime?"
A: "Yes."
→ Missed opportunity to build trustEnterprise Tier Copy
| Element | Best Practice |
|---|---|
| Name | "Enterprise" or "Custom" |
| Price | "Contact us" or "Custom pricing" |
| Description | List enterprise needs it serves |
| Features | Security, compliance, scale, support |
| CTA | "Talk to sales" or "Get a quote" |
Good Enterprise Section
✓ "Enterprise"
For organizations with advanced security and scale needs.
Everything in Team, plus:
• SAML SSO & SCIM
• SOC 2 Type II compliance
• 99.99% SLA
• Dedicated success manager
• Custom integrations
• Volume discounts
[Talk to sales]
Usually responds within 24 hoursSocial Proof for Pricing Pages
| Type | Example | Placement |
|---|---|---|
| ROI testimonial | "Paid for itself in the first week" | Near pricing tiers |
| Value quote | "Best investment we've made" | Below tiers |
| Customer logos | Tier-specific logos | Within tier cards |
| Metric | "Teams save 10+ hours/week" | Above tiers |
Pricing Page CTAs
| Tier Type | Primary CTA | Alternative CTA |
|---|---|---|
| Free tier | "Get started free" | — |
| Paid tier (no trial) | "Start [Tier Name]" | "Compare plans" |
| Paid tier (with trial) | "Start free trial" | "See a demo" |
| Enterprise | "Talk to sales" | "Book a demo" |
Friction Reducers
| Objection | Friction Reducer |
|---|---|
| "What if it doesn't work for us?" | "14-day free trial" |
| "What if we need to cancel?" | "Cancel anytime" |
| "Is this secure?" | "SOC 2 compliant" badge |
| "Will we get help?" | "24/7 support included" |
| "What about credit card?" | "No credit card required" |
| "Is this the best price?" | "Save 20% with annual" |
Pricing Page Checklist
- [ ] Headline frames value, not just "Pricing"
- [ ] 2-4 clearly differentiated tiers
- [ ] Recommended tier is visually highlighted
- [ ] Each tier has a clear audience description
- [ ] Feature comparison is scannable
- [ ] FAQ addresses top objections
- [ ] Social proof focused on value/ROI
- [ ] Enterprise option with clear CTA
- [ ] Friction reducers visible (trial, cancel policy)
- [ ] Mobile-optimized tier display
Anti-Patterns
- Hidden pricing — If you hide it, people assume the worst
- Too many tiers — 3-4 is ideal, more creates confusion
- Feature overload — Highlight differences, not everything
- Jargon in features — "SSO" needs explanation for some audiences
- Buried enterprise option — Make it easy to find for large buyers
- No social proof — Pricing pages need trust signals
- Vague enterprise tier — "Contact us" with no features listed
- Missing FAQ — Unanswered questions = lost conversions
- No recommended tier — Help people choose
- Complex pricing math — Per user + per seat + usage = confusion
Product Tour Pages
Impact: HIGH
Product tour pages show your product in action before signup. They reduce the friction of "I need to see it first" and give visitors confidence about what they're getting into.
Product Tour Types
| Type | Format | Best For |
|---|---|---|
| Interactive demo | Clickable prototype | Complex products |
| Video tour | 2-5 minute walkthrough | Story-driven products |
| Screenshot tour | Guided visual flow | Simple products |
| Live sandbox | Read-only product access | Technical products |
| Animated walkthrough | Motion-based tour | Visual products |
Product Tour Structure
┌────────────────────────────────────────────────────┐
│ 1. INTRO/HOOK │
│ What they'll see + time commitment │
│ "See how [Product] works in 3 minutes" │
├────────────────────────────────────────────────────┤
│ 2. KEY WORKFLOW #1 │
│ Core job-to-be-done │
│ Setup or getting started flow │
├────────────────────────────────────────────────────┤
│ 3. KEY WORKFLOW #2 │
│ Primary value moment │
│ "This is where the magic happens" │
├────────────────────────────────────────────────────┤
│ 4. KEY WORKFLOW #3 │
│ Secondary value or collaboration │
│ Team features, sharing, results │
├────────────────────────────────────────────────────┤
│ 5. OUTCOME │
│ What they've accomplished │
│ Results or deliverable │
├────────────────────────────────────────────────────┤
│ 6. CTA │
│ "Start free" or "Try it yourself" │
└────────────────────────────────────────────────────┘Tour Page Headlines
| Formula | Example | Tone |
|---|---|---|
| See [Product] in action | "See Acme in action" | Direct |
| [Time] tour | "A 3-minute tour of Acme" | Time commitment |
| How [Product] works | "How Acme works" | Educational |
| Experience [Product] | "Experience the Acme difference" | Experiential |
Good Tour Headlines
✓ "See how teams ship faster with Acme"
→ Outcome-focused, audience clarity
✓ "A 3-minute tour of your new workspace"
→ Time commitment + ownership language
✓ "Watch: From zero to deployed in 5 minutes"
→ Specific outcome, time-based
✓ "Take Acme for a spin"
→ Casual, low-pressureBad Tour Headlines
✗ "Product Demo"
→ Generic, no value proposition
✗ "Watch Our Amazing Features"
→ Self-congratulatory
✗ "Welcome to the Acme Experience"
→ Vague, no clear expectation
✗ "Click Here to Learn More"
→ Not a headline, weak CTAWriting Tour Narration/Copy
Each tour step needs: 1. What they're seeing (orient the viewer) 2. Why it matters (connect to their goal) 3. What to notice (guide attention)
Good Tour Step Copy
✓ Step 1: "Connect your repository"
"Start by connecting your GitHub repo. One click, and Acme
automatically syncs with every branch. No config files needed."
[Screenshot showing GitHub connection UI]
✓ Step 2: "See your first insights"
"Within seconds, you'll see code quality metrics across your
entire codebase. Spot issues before they become problems."
[Screenshot showing dashboard with metrics]
✓ Step 3: "Share with your team"
"Invite teammates in seconds. Everyone sees the same view,
comments stay connected to the code."
[Screenshot showing team invitation flow]Bad Tour Step Copy
✗ "Step 1: Here is the dashboard"
→ No value, just labeling
✗ "This is our powerful integration engine"
→ About you, not them
✗ "Next, click the blue button"
→ Instructions without value
✗ "As you can see, there are many features here"
→ Vague, unfocusedScreenshot Guidelines
| Element | Best Practice |
|---|---|
| Size | Large enough to read key UI elements |
| Focus | Highlight the relevant area (blur or dim surroundings) |
| Data | Use realistic, relatable sample data |
| Annotations | Arrows or callouts for complex screens |
| Sequence | Clear visual flow between steps |
| Freshness | Update when UI changes |
Good Screenshot Practices
✓ Show realistic data
Project names like "Q4 Marketing Campaign" not "Test Project 1"
✓ Highlight the focus area
Dim or blur irrelevant parts of the screen
✓ Use callouts sparingly
One arrow pointing to the key element
✓ Show before/after
Empty state → filled state progression
✓ Include realistic team members
"Sarah (Marketing)" not "User 1"Bad Screenshot Practices
✗ Empty or dummy data
"Lorem ipsum" or "Test data here"
✗ Cluttered annotations
10 arrows pointing everywhere
✗ Full screenshot with no focus
Everything equally visible
✗ Outdated UI
Screenshots from 3 versions ago
✗ Admin/debug views
Technical screens normal users won't seeVideo Tour Best Practices
| Element | Guideline |
|---|---|
| Length | 2-4 minutes optimal |
| Pace | Fast enough to hold attention, slow enough to follow |
| Audio | Professional voiceover or on-screen text |
| Music | Subtle background, never overpowering |
| Resolution | 1080p minimum, 4K preferred |
| Captions | Always include (many watch muted) |
Good Video Structure
✓ 0:00-0:15 — Hook: The problem/outcome
"Tired of losing track of customer requests?"
✓ 0:15-1:00 — Setup: Quick context
"Let me show you how Acme solves this in 3 steps"
✓ 1:00-3:00 — Core workflow
Show the primary use case, narrate value
✓ 3:00-3:30 — Results
"Now you have a complete view of..."
✓ 3:30-4:00 — CTA
"Start your free trial at acme.com"Interactive Demo Guidelines
| Element | Best Practice |
|---|---|
| Guidance | Clear tooltips showing next action |
| Progress | Indicator showing tour position |
| Skip option | Let users jump ahead or exit |
| Reset option | Way to start over |
| Real feel | Mimics actual product closely |
| Limitations | Clear what's demo vs full product |
Good Interactive Demo Copy
✓ Tooltip: "Click here to create your first project"
Hint: In the real product, you can create unlimited projects.
✓ Progress: "Step 2 of 5: Setting up integrations"
✓ Callout: "This is where your team's activity appears"
Notice how every action is timestamped and attributed.
✓ End screen: "That's the basics! Ready to try the real thing?"
[Start free trial] [Replay tour]Tour Completion CTAs
| Tour Type | Primary CTA | Secondary CTA |
|---|---|---|
| Video | "Start free trial" | "Watch more videos" |
| Interactive | "Try it yourself" | "Book a demo" |
| Screenshot | "Get started free" | "See pricing" |
| Sandbox | "Create your account" | "Talk to sales" |
Good Tour CTAs
✓ After video: "Ready to try it yourself?"
[Start free trial — no credit card required]
✓ After interactive: "That was just a preview"
[Create your free account and explore everything]
✓ After screenshot tour: "Seeing is believing"
[Start free] or [Book a personalized demo]Tour Page Metrics
| Metric | Target | What It Measures |
|---|---|---|
| Completion rate | >60% | Tour engagement |
| Time on page | 2-5 min | Content quality |
| CTA click rate | >10% | Persuasiveness |
| Drop-off points | N/A | Content issues |
Tour Page Checklist
- [ ] Headline sets clear expectation (time, content)
- [ ] Tour follows logical workflow
- [ ] Each step has value-focused copy
- [ ] Screenshots/videos use realistic data
- [ ] Focus areas are highlighted
- [ ] Progress indicator shows position
- [ ] Skip/exit options available
- [ ] CTA appears at end and optionally throughout
- [ ] Mobile experience is considered
- [ ] Tour stays updated with product changes
Anti-Patterns
- Feature parade — Tours should follow workflows, not feature lists
- No context — Don't show screens without explaining why they matter
- Stale content — Outdated screenshots erode trust
- Too long — Attention drops after 4-5 minutes
- No clear CTA — Tour should lead somewhere
- Forced completion — Let people skip or exit
- Technical jargon — Tours are for prospects, not power users
- Perfect scenarios — Show realistic use, not idealized demos
- Missing audio/captions — Many watch without sound
- Desktop only — Consider mobile viewers
Use Case and Solution Pages
Impact: MEDIUM-HIGH
Use case pages answer "Is this for me?" by showing your product through the lens of specific personas, industries, or problems. They turn generic features into relevant solutions.
Types of Solution Pages
| Type | URL Pattern | Example |
|---|---|---|
| Persona | /solutions/[role] | /solutions/engineering-teams |
| Industry/Vertical | /solutions/[industry] | /solutions/healthcare |
| Problem | /solutions/[problem] | /solutions/remote-collaboration |
| Use case | /use-cases/[use-case] | /use-cases/sprint-planning |
| Company size | /solutions/[segment] | /solutions/enterprise |
Solution Page Structure
┌────────────────────────────────────────────────────┐
│ 1. HERO │
│ "[Product] for [Audience/Problem]" │
│ Segment-specific value prop │
├────────────────────────────────────────────────────┤
│ 2. PROBLEM STATEMENT │
│ "You know the pain of..." │
│ Specific to this audience │
├────────────────────────────────────────────────────┤
│ 3. SOLUTION OVERVIEW │
│ How your product addresses their needs │
│ Audience-relevant features highlighted │
├────────────────────────────────────────────────────┤
│ 4. KEY CAPABILITIES │
│ Features framed for this audience │
│ 3-5 most relevant capabilities │
├────────────────────────────────────────────────────┤
│ 5. SOCIAL PROOF │
│ Testimonials/cases from similar customers │
│ Logos from the same segment │
├────────────────────────────────────────────────────┤
│ 6. WORKFLOW/USE CASE EXAMPLES │
│ "Here's how [Audience] uses [Product]" │
│ Day-in-the-life scenarios │
├────────────────────────────────────────────────────┤
│ 7. COMPARISON TO STATUS QUO │
│ Before/after or vs spreadsheets/old way │
├────────────────────────────────────────────────────┤
│ 8. CTA │
│ Segment-specific call to action │
└────────────────────────────────────────────────────┘Solution Page Headlines
| Formula | Example | Best For |
|---|---|---|
| [Product] for [Audience] | "Acme for Engineering Teams" | Persona pages |
| [Outcome] for [Audience] | "Faster deploys for DevOps teams" | Outcome-led |
| [Problem] solved | "Finally, sprint planning that works" | Problem-focused |
| Built for [Audience] | "Built for startups" | Audience validation |
Good Solution Headlines
✓ "Project management built for engineering teams"
→ Clear audience + category positioning
✓ "Ship faster without the chaos"
→ Outcome + pain point addressed
✓ "Enterprise-grade security, startup-speed setup"
→ Addresses enterprise concerns with agility
✓ "Remote teams deserve better tools"
→ Validates the audience + implies solutionBad Solution Headlines
✗ "Solutions"
→ Says nothing
✗ "Our Enterprise Offering"
→ About you, not them
✗ "Acme for Everyone"
→ Defeats the purpose of segmentation
✗ "The Best Project Management Tool"
→ Generic, undifferentiatedWriting Problem Statements
Speak to the specific pain points of this audience:
Persona-Specific Problems
| Persona | Problem Statement |
|---|---|
| Engineering | "Your engineers are drowning in tickets, context-switching between tools, and losing hours to status updates that could be automated." |
| Marketing | "Campaign assets are scattered across Dropbox, Drive, and email threads. Feedback gets lost. Deadlines slip." |
| Sales | "Your CRM says one thing, your inbox says another, and your forecast is a guess at best." |
| Operations | "Process documentation lives in someone's head. Onboarding takes weeks. Mistakes repeat." |
Industry-Specific Problems
| Industry | Problem Statement |
|---|---|
| Healthcare | "Patient coordination requires HIPAA compliance, but most tools weren't built for healthcare." |
| Finance | "Audit trails, compliance requirements, and data security aren't optional — they're table stakes." |
| Startups | "You need enterprise tools at startup prices, with zero implementation headaches." |
Good Problem Section
✓ "Engineering teams spend 30% of their time on coordination, not code.
You've tried Jira. You've tried spreadsheets. You've built internal tools.
But sprint planning still takes hours. Standups still run over. And nobody
knows what shipped last week without digging through Slack.
Sound familiar?"Bad Problem Section
✗ "Companies today face many challenges in the modern business landscape.
Collaboration is increasingly important, and teams need tools that
help them work together effectively."
→ Generic, could apply to anyoneFeature Framing by Audience
Same feature, different framing:
| Feature | For Engineering | For Marketing | For Ops |
|---|---|---|---|
| Automations | "Automate ticket routing and status updates" | "Auto-assign tasks when campaigns launch" | "Trigger workflows on new hires" |
| Dashboards | "Track sprint velocity and deployment frequency" | "See campaign performance at a glance" | "Monitor SLA compliance" |
| Integrations | "Connect GitHub, Slack, and CI/CD" | "Sync with HubSpot and Google Analytics" | "Link to HRIS and payroll" |
Good Capability Sections
✓ "For Engineering Teams"
Sprint planning in minutes, not hours
Drag-and-drop planning with automatic capacity calculation.
Know exactly what fits in each sprint.
Every code change, tracked
GitHub integration links commits to tasks automatically.
See the full context without leaving your workflow.
Standups that run themselves
Automated standup prompts and rollups.
Get updates in Slack, keep everyone moving.Bad Capability Sections
✗ "Features"
• Advanced dashboard capabilities
• Real-time collaboration features
• Powerful integration engine
• Enterprise-grade security
→ Generic, not audience-specificSocial Proof Strategy
| Audience | Proof Type | Example |
|---|---|---|
| Enterprise | Logo bar + compliance certs | "Trusted by 500+ enterprises, SOC 2 certified" |
| Startups | Growth metrics + funded logos | "10,000+ startups including Y Combinator cos" |
| Specific industry | Industry logos + quote | "How Stripe's engineering team ships faster" |
| Specific role | Role-specific testimonial | Quote from VP Engineering |
Good Social Proof
✓ "Engineering teams at Stripe, Figma, and Linear use Acme to ship faster"
"We cut our sprint planning time by 60% and actually enjoy standups now."
— Marcus Chen, VP Engineering, Linear
✓ "Trusted by 500+ healthcare organizations"
[Logos: Cleveland Clinic, Kaiser, One Medical]
HIPAA compliant • SOC 2 Type II • BAA availableUse Case Example Format
✓ "A day in the life with Acme"
8:30 AM — Morning standup
Your team's updates are already collected. Just review and go.
10:00 AM — Sprint planning
Drag tasks, see capacity, assign work. Done in 15 minutes.
2:00 PM — Code review
PR merged, task auto-updated, Slack notified. No manual steps.
5:00 PM — End of day
Your dashboard shows what shipped. Ready for tomorrow's standup.Before/After Comparisons
| Element | Before (Status Quo) | After (Your Product) |
|---|---|---|
| Tool | Spreadsheets, email | One unified platform |
| Time | Hours | Minutes |
| Outcome | Confusion, delays | Clarity, speed |
| Feeling | Frustration | Confidence |
Good Before/After
✓ Before Acme:
• Sprint planning takes 3+ hours
• Status updates buried in Slack
• Nobody knows what shipped
After Acme:
• Planning done in 30 minutes
• Updates automatic and visible
• Real-time shipping dashboardSegment-Specific CTAs
| Audience | Primary CTA | Secondary CTA |
|---|---|---|
| Enterprise | "Talk to sales" | "See security overview" |
| Startup | "Start free" | "See startup pricing" |
| Technical | "Read the docs" | "Try the API" |
| Non-technical | "See it in action" | "Book a demo" |
Solution Page Checklist
- [ ] Headline speaks directly to the audience
- [ ] Problem statement is audience-specific
- [ ] Features are framed for this audience
- [ ] Social proof from similar customers
- [ ] Use cases relevant to their workflow
- [ ] Before/after shows clear improvement
- [ ] CTA matches audience expectations
- [ ] Cross-links to relevant case studies
- [ ] Page can stand alone (visitors may land here first)
SEO Optimization
| Element | Best Practice |
|---|---|
| Title | "[Product] for [Audience] |
| Meta | "[Product] helps [Audience] [outcome]. [Specific benefit]..." |
| H1 | "[Product] for [Audience]" |
| URL | /solutions/[audience-slug] |
| Content | Naturally include role/industry terms |
Anti-Patterns
- Copy-paste pages — Each solution page must be genuinely different
- Generic features — Frame everything for the specific audience
- Wrong social proof — Enterprise logos on startup page fails
- No problem validation — Show you understand their pain
- One-size-fits-all CTAs — Enterprises want to "talk to sales"
- Missing specificity — "Marketing teams" is too broad
- Ignoring objections — Address segment-specific concerns
- No workflow examples — Show the product in their context
- Jargon mismatch — Use their vocabulary, not yours
- Orphaned pages — Link from navigation and other pages
Related skills
How it compares
Choose website-copy-specialist over generic writing or SEO skills when you need page-type-specific conversion frameworks—hero hierarchy, pricing tier framing, and feature benefit ladders—for a product marketing site rath
FAQ
What page types does website-copy-specialist cover?
website-copy-specialist covers nine SaaS and B2B page types: homepage, feature, about, pricing, comparison, product tour, integration, use case, and demo or contact pages. Each page type includes defined primary goals, tone guidance, and recommended CTA patterns.
How does website-copy-specialist organize its copy guidelines?
website-copy-specialist stores guidelines in a rules/ directory grouped by ten page-type prefixes such as homepage-*, pricing-*, and comparison-*. The agent applies shared frameworks including a six-step Clarity Hierarchy and an eight-section homepage layout when drafting copy.
When should a developer invoke website-copy-specialist?
website-copy-specialist fits pre-launch or relaunch work on SaaS and B2B marketing sites. Invoke it when drafting homepage hero messaging, pricing tier differentiation, benefit-led feature pages, competitive comparison copy, or navigation and demo-page microcopy.
Is Website Copy Specialist safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.