How to Turn Keyword Notes Into a WordPress Outline with Claude
Group keyword notes by reader question, give Claude a bounded outline request, and check whether an existing WordPress post should be improved instead.
A keyword export is a collection of clues, not a table of contents. It may mix synonyms, troubleshooting questions, product names and unrelated ideas. Promoting each row into an H2 makes a long page that repeats itself. The editor’s first job is to decide which reader problem the page will solve.
Sort the notes by question and outcome
Use this constructed example, not a claim about TopTut search demand: “WordPress image alt text,” “decorative image alt,” “linked image alt,” “chart alt text,” and “image search visibility.” The first four could support a guide on choosing text alternatives for different image purposes. The last is broader and may attract readers whose goal is image search optimization. It should not control an accessibility guide’s structure just because it shares a word.
Before creating a new URL, check whether a current page already answers the task. TopTut has a WordPress image-alt-text guide. In this example, the useful output may be a revision brief for that page, not another post competing for the same reader.
| Note | Reader question | Outline decision |
|---|---|---|
| decorative image alt | When should the text alternative be empty? | Answer in a purpose-based section. |
| linked image alt | Should the text describe the image or link action? | Answer with a functional-image example. |
| chart alt text | How much detail belongs beyond short alt text? | Include only with a sourced example and a longer text equivalent. |
| image search visibility | How do images appear in search? | Separate task; do not force into this outline. |
Give the assistant an evidence-bound outline request
Reader: [who is this for]. One result the reader needs: [specific outcome]. Raw keyword notes: [paste; include source and date if known]. Existing related pages: [URLs and one-sentence purpose]. Verified source material: [URLs or excerpts]. Group notes by distinct reader question. Mark duplicates and off-topic notes. Propose an H1 and at most five main sections in task order. For each section, state the question it answers, a concrete example, and the source needed for any factual claim. Do not infer search volume, ranking difficulty, product features, or first-hand tests from the notes. If an existing page already serves this task, recommend a revision instead of a new post.
The request makes the assistant show its grouping decisions. A heading without a distinct reader question can be cut. A proposed claim without a source becomes a research item. The prompt’s section limit is a working constraint for this example, not a rule for all articles; a complex subject may need more, while a narrow answer may need fewer.
Turn the proposal into an outline a writer can use
- H1: Choose WordPress image alt text by the image’s purpose. Opening: state the informative, decorative and functional distinction in plain language.
- H2: What information does this image add? Use an informative screenshot example and explain what a short text alternative must convey.
- H2: When is the image decorative? Show when an empty alternative is appropriate.
- H2: What if the image is a link or button? Describe the destination or action, using a real example.
- H2: What if the image is a chart or diagram? Specify the short label and where the detailed equivalent belongs.
- H2: Where do you set and verify the text in WordPress? Include the editor field and a rendered-page check.
This is a sample revision outline, not a report of what the assistant produced. It starts with the reader’s decision, then covers cases that change the answer. The W3C image tutorial supports the informative, decorative, functional and complex distinctions. WordPress’s Image block guide documents where the per-post alternative text is set and when an image can be marked decorative. Those sources should be read when drafting the actual examples.
Reject headings that only mirror phrases
“Benefits of alt text,” “Why alt text matters,” and “The future of image descriptions” could fill space without moving the reader through a choice. A heading earns its place by changing what the reader can do next. If two phrases have the same answer, combine them. If a phrase requires a separate audience or outcome, move it to another brief. If it reflects a current product fact, verify the fact before it enters the outline.
Before moving the outline into WordPress, compare it with the existing page’s H1, quick answer and sections. Preserve any good explanation already there. Check that the title promises exactly what the sections deliver, and that links point to the actual source or next step. This is an editorial map, not an instruction to publish every phrase in the export.
Frequently asked questions
How do I turn keyword research into a blog post outline?
Group phrases by the reader question they express, choose one task for the page, and put the needed answers in task order. Keep a heading only when it adds a distinct step, decision or example.
Can Claude create an outline from a keyword list?
It can propose groups and headings when given the raw notes, reader task, existing related pages and verified sources. Review the grouping yourself; a plausible heading is not proof of search demand or factual accuracy.
Should every keyword become an H2 heading?
No. Synonyms and close variants often share one answer. Combine them under a natural heading, and move phrases that imply a different audience or outcome to another brief.
How many sections should a WordPress outline have?
Use the number needed to answer the task. A short guide may need only a few sections; a complex decision may need more. The five-section limit in the article’s sample prompt is a drafting constraint, not a publishing rule.
What if I already have a post covering the same keyword topic?
Read the existing page first. If it serves the same reader task, prepare a revision brief for that URL instead of publishing a competing post. Create a new article when the audience, question or outcome is genuinely different.
How do I check an AI-generated outline before drafting?
For every proposed section, name the question it answers, a concrete example and the source needed for factual claims. Remove duplicate or off-topic headings, then compare the outline with the title, quick answer and related existing pages.
