---
name: page-anatomy
description: Draft or review a website page so it does one job, in the right order. Use when the user is writing, rewriting or reviewing a home, About, service, industry, product, case study, guide, questions (FAQ) or contact page.
---

# Page anatomy

Every page on a site has one job. A page that tries to do three jobs doesn't do any of them well. You draft or review one page at a time against the anatomy for its kind.

## Read these first

- `context/buyer.md`
- `context/one-sentence.md`
- `context/voice.md`
- `context/proof.md`

## How to work

1. Ask which kind of page this is. If the page is trying to be two kinds, say so and ask the user to choose.
2. For a new page, ask for the facts you need, then draft it in order. Job, top, then, close, links.
3. For a page that exists, go through the anatomy line by line. Say what's there, what's missing and what's in the wrong place. Then write the fixes as copy that's ready to drop in.
4. Finish with the links in and out, and a list of anything the owner still has to approve.

## Four things every page carries

- One main heading in the buyer's own words.
- A title and a description for search results that no other page on the site shares.
- One clear next step.
- The one sentence that says what the company is and who it serves, at least in the footer.

## The anatomies

### Home page

- **Job.** Tell a first-time visitor what you make, who you make it for and why they should choose you. Then send them to the right page.
- **Top.** A heading that says what you do and who it's for, in the buyer's words. One sentence to back it up. One button for the next step.
- **Then.** Proof a stranger can check, like customer names, years in business and certifications. A short block for each main service or product, and each one links to its own page. One customer story with a result.
- **Close.** The next step again, and the one sentence that says what you are and who you serve.
- **Links.** Down to every service, industry and product page. Put those links in the body of the page as well as the menu.
- **Rule.** If your heading could sit on a competitor's site, rewrite it.

### About page

- **Job.** Tell a buyer who you are and why they can trust you.
- **Top.** The one sentence that says what you are and who you serve, word for word the way it reads everywhere else.
- **Then.** How the company started, and what it's stood for since. The people a buyer will deal with, with names, roles and photos. Facts a stranger can check, like the year you started, your address, your certifications and the groups you belong to.
- **Close.** A way to talk to a person.
- **Links.** Out to your service pages and case studies. In from the home page, the footer and the writer's name on every post.
- **Rule.** Names and dates beat adjectives. "Family owned since 1974" says more than "a tradition of excellence."

### Service or capability page

- **Job.** Answer one buyer's need for one thing you do. One service gets one page.
- **Top.** The buyer's question or need as the heading. Then the answer, in the first 40 to 90 words.
- **Then.** Who it's for. How the work runs, in steps with names. What the buyer has at the end. Proof from a customer like them. What drives the cost, if you can say. Three to five questions a buyer would ask, each with a short answer.
- **Close.** One next step, and one line that says who does this work and who it's for.
- **Links.** Down to the case studies and posts that back it up. In from the home page, the menu and every post on the same subject.
- **Rule.** This is the page you most want found. So send more of your own links here than to any post.

### Industry page

- **Job.** Show one kind of buyer that you know their world. One industry gets one page.
- **Top.** A heading that names the buyer. Then the problem they bring you, in their words.
- **Then.** What's different about doing this work for them, like the standards, the paperwork or the timing. The services they use most. Proof from a customer in that industry. The questions they ask most.
- **Close.** The next step, worded for that buyer.
- **Links.** Out to the services and case studies that fit. In from the home page, and from every case study in that industry.
- **Rule.** Only build this page when you have proof from that industry. A page with no proof tells the buyer you're guessing.

### Product page

- **Job.** Give a buyer or an engineer what they need to decide if this product fits, without a phone call.
- **Top.** The product's plain name, what it does and what it's used for. A clear photo of the real thing.
- **Then.** The specs in a table, with units. Specs are the sizes and numbers that describe the product. What it works with. Drawings, data sheets and certifications to download. How long it takes to get and how to order, if you can say. The questions people ask most.
- **Close.** Ask for a quote, or talk to a person who knows the product.
- **Links.** Up to the page for its product family. Across to related products. Out to a case study that uses it.
- **Rule.** Put the specs on the page as text. Numbers locked inside a PDF or a picture are hard for a buyer to search and hard for a machine to read.

### Case study page

- **Job.** Let a buyer watch you solve a problem like theirs.
- **Top.** The customer, what they make and the problem, in one or two sentences. The result, if you have a number the customer has approved.
- **Then.** Where they started. What you did, in order. What changed. A quote from the customer in their own words. Photos of the real work.
- **Close.** The service this story proves, with a link, and the next step.
- **Links.** Up to the service page it proves and the industry page it belongs to. Both of those pages link back down to it.
- **Rule.** Nothing goes on this page that the customer hasn't approved.

### Guide page

- **Job.** Be the one full answer to a big question your buyer asks. It's also the front door to every post on that subject.
- **Top.** The question as the heading. The short answer in the first 40 to 90 words. A list of what the guide covers, with each item linking to its part.
- **Then.** Each part of the answer under its own heading. Numbers that say where they came from. A short summary of each related post, with a link to the full post.
- **Close.** Who wrote it, the date it was last updated and the service that helps with this.
- **Links.** Down to every post on the subject. Each of those posts links back up.
- **Rule.** One guide per subject. When you learn something new, update the guide. Don't write a second one.

### Questions page

- **Job.** Answer the questions buyers ask before they call, all in one place.
- **Top.** A heading that says whose questions these are. Skip the introduction.
- **Then.** Each question written the way a buyer would type it. Each answer makes sense on its own, in a few sentences. Questions grouped by subject.
- **Close.** A way to ask a question that isn't on the page.
- **Links.** Each answer links to the page that covers it in full.
- **Rule.** Use real questions. Get them from sales calls, emails and your own search data.

### Contact page

- **Job.** Make the next step easy, and tell the buyer what happens after.
- **Top.** What the buyer gets when they reach out, and how soon a person answers.
- **Then.** A short form that only asks for what you need to reply. A phone number and an email address as text. Your street address and hours. A name and a face, if you can.
- **Close.** What happens next, in a sentence or two.
- **Links.** Every page links here. This page links out to very little.
- **Rule.** Ask how they found you, and list AI tools as one of the answers.

## Rules

- Use only proof from the proof file. If a client hasn't approved it, leave it out.
- Don't invent a name, a number, a quote or a result. Leave a marked blank and ask.
- Headings use the buyer's words. Trade terms can sit lower on the page.
- Nothing goes live without a yes from the owner.

---

From The search playbook by Wit & Craft. witandcraft.com
