Content Brief & Template
Turns one keyword into a writer-ready brief — target length, heading structure, semantic keywords, real questions and the pages you are up against.
Last updated 2026-08-06
Summary#
Content Brief & Template turns a keyword into a complete writing spec: target word count and reading level, the heading structure, the semantic keywords to cover, the real People-Also-Ask questions, and the pages currently ranking. It holds two tools behind one sidebar row — SEO Brief (seo_brief) and Content Template (content_template), 1 credit each.
Purpose#
Most content underperforms because it was scoped by guesswork. Someone picked a length, invented headings and hoped the topic was covered.
This tool replaces that with a spec grounded in the live search results for your keyword. The decision it supports is what to write: how long, in what structure, covering which terms and answering which questions — settled before a writer starts.
Overview#
Both tabs share the same grounding. You enter a keyword, and Metric Vault fetches in parallel:
- related keyword suggestions for the term, up to 30, with volume, cost-per-click and competition,
- the live Google organic results for the term, read to a depth of 30, including the real titles, descriptions, People-Also-Ask questions and related searches,
- a real difficulty score for the keyword.
That grounding is then written up. SEO Brief produces a hand-off document for a writer. Content Template produces an on-page specification with a scored brief, a competitor comparison and a 30-day plan. They read the same SERP; they differ in what they emphasise.
The two tabs sit at the top of the view. Switching tabs switches views — each tab keeps its own input and its own result.
Benefits#
- The word count, heading count and reading level come from the pages actually ranking, not from a rule of thumb.
- Real People-Also-Ask questions arrive ready to use as sections.
- The competing-pages list shows whether the keyword is winnable before you commit a writer to it.
- Semantic keywords give a coverage checklist rather than a density target.
- 1 credit per run, which keeps it below the monthly premium threshold.
Content Templatehands off directly to the article writer in one click.
Use Cases#
Briefing a writer. Export the brief and send it. The word target, structure, questions and competitors are all in one document.
Deciding whether to write at all. A difficulty near 80 with national publishers in the top ten is a signal to pick a different angle.
Rebuilding an underperforming page. Run the brief for the target keyword, and compare it with what the page currently does.
Filling an editorial calendar. Content Template closes with a 30-day plan you can drop into a schedule.
Feeding the article writer. Generate Full Article carries the keyword straight into the full draft.
Requirements#
- A signed-in account.
- A paid plan — 1 credit per run, and any cost above zero is blocked on Free.
- Available credits and hourly headroom.
- No integration and no verified domain.
Permissions#
Any workspace member on a paid plan can run either tab. Free accounts are refused with This tool needs a paid plan. Free includes the 10 technical SEO tools; upgrade to Pro to unlock the rest. Signed-out visitors see Please sign in to run this tool. The recommendations panel needs Pro or above.
Cost#
1 credit per run, on each tab. Running SEO Brief and then Content Template on the same keyword is two runs and two credits.
At 1 credit both sit below the premium threshold of 3, so neither is blocked by your monthly quota — only by the hourly fair-use cap of 100 light-tool calls per hour. Neither tab is served from the shared cross-customer cache, so every run is a fresh write-up, although the underlying keyword and SERP fetches are cached for one hour to one day. Repeating the same keyword within that window still charges the credit. See How credits work and Result caching and freshness.
Generate Full Article on the Content Template result starts the article writer, which is a further 1 credit.
Navigation Path#
Dashboard → Write & Optimize → Content Brief & Template
The view opens on the SEO Brief tab. Content Template is the second tab in the strip at the top.
Inputs#
| Field | Accepts | Required | Default | Validation | Notes |
|---|---|---|---|---|---|
SEO Brief: e.g. email marketing | A keyword or topic phrase | Yes | Empty | Empty shows Enter a value first. | Two to four words works best. Enter runs the tool |
Content Template: e.g. how to start a podcast | A keyword or topic phrase | Yes | Empty | Empty shows Enter a value first. | The view shows Tip: hit Enter after typing |
Try sample (Content Template) | — | No | — | — | Runs the tool with whatever is currently in the field; it does not insert an example |
| Country picker (topbar) | Country list | No | United States | — | Recorded with the run, but keyword and SERP data always come from the United States, English-language index |
| Date range (topbar) | — | — | — | — | Hidden on this view; a brief always reflects the current SERP |
Step-by-Step Guide#
- Open
Write & Optimizeand choose Content Brief & Template. - Stay on the SEO Brief tab, or click Content Template.
- Type your keyword into the field.
- Click Generate Brief · 1 report on the SEO Brief tab, or Build Template · 1 report on the Content Template tab. Enter works too.
- Wait for
Analyzing… this can take a few seconds for live data.to clear — the view estimates 15 to 30 seconds per keyword. - Read the KPI row first to decide whether the keyword is worth the page.
- Take the structure: on Content Template use Export Brief or Generate Full Article; on either tab use the export row above the tool.
Reading the Results#
SEO Brief#
The header. Your topic, a SEO Brief verified badge and Generated just now.
The four KPI tiles.
| Tile | Sub-label | Reads | Good | Bad | Action |
|---|---|---|---|---|---|
Search Intent | N% of demand | The dominant intent for the keyword | A single intent above about 60% | An even split | Mixed intent means one page cannot satisfy the query — split it |
Target Words | N min read | Recommended length | Matches the ranking pages | Far above or below them | Write to the target, not past it |
Difficulty | Easy to rank (≤30), Moderate (≤60), Hard to rank (above) | Keyword competition, 0-100 | Under 30 | Over 60 | Above 60 you need links and depth, not just a good post |
Competing Pages | ranking in SERP | How many ranking pages were read | 8-10 | — | No SERP data means the write-up is thinner — re-run or broaden the keyword |
Title Options. Several angles, each with a style chip and a hook-strength score. A hook of 66 or above renders green, 33 to 65 amber, below that red. Pick the angle that matches the intent tile, not the highest number in isolation.
Meta Snippet. A proposed title tag and description with live character counts. The title reads green between 50 and 60 characters; the description reads green between 140 and 160. Both go red outside the tolerance. For more variants, use Meta Generator.
Content Outline. The section structure, level by level. This is the part a writer works from directly.
Content Brief. The written brief itself, if the structured outline was not produced.
Target Keywords. The terms the page should cover.
Search Intent Mix. The intent split behind the demand, expanded from the KPI tile.
On-Page Targets. A spec table: Target word count, Reading time, Headings, Reading level, Images, Internal links, External links and Keyword density. Treat these as the definition of done for the draft.
People Also Ask. Real questions from the live results. Each is a section heading or an FAQ entry.
Competing Pages. The pages you have to beat. Read the titles for the angle that is already saturated, and the domains for whether the head term is realistic.
Reference Sources. Where the supporting material came from.
Strategy Notes. Written guidance on how to approach the piece.
Content Template#
The header. The keyword plus a Brief score N/100 pill — green at 80 or above, brand-colored from 60, amber below. The score reflects how much real grounding the brief has, so a low score usually means a thin or unusual keyword.
Beside those sits the search volume, the CPC and — only when the run was grounded in measured data — a Live · DataForSEO + AI badge. If the badge is absent the outline is still useful, but it was generated without live search data behind it, so treat the volume and difficulty figures as indicative rather than measured. The badge used to be drawn on every run regardless, which made an AI-only result look identical to a measured one.
When nothing could be generated. A keyword that returns no competitors, no semantic keywords, no headings, no questions and no volume produces a short No content template could be generated for <keyword> yet message rather than a report. There is no score, no export row and no share link on that screen, because there is nothing behind them. Try a clearer or more specific keyword.
The four KPI tiles. Target Words with the reading level as its sub-label; Difficulty out of 100 with a plain-language read (low barrier under 40, plan link-building under 70, multi-month effort above); Top Competitors counted from the live Google SERP; and PAA Questions, labelled answer-box targets.
Header actions. Generate Full Article sends the keyword to the AI Article Generator's Full Article Writer tab and runs it, which costs a further credit. Export Brief downloads the whole brief as a Markdown file named after the keyword. Save to Hub stores it in your browser and confirms how many briefs you now hold.
Live Metrics — DataForSEO Labs. Three measured numbers: Monthly Searches (real search demand), Avg CPC (commercial intent — a high CPC means buyers, not readers) and Semantic Cluster (how many related keywords were found).
Google SERP Preview. How the proposed title and description would render.
What This Brief Tells You. The plain reading of the numbers above.
Real Top-N Competitors. The ranking pages, numbered by position, with their titles and URLs. N is however many were returned.
Recommended Headings. The H2/H3 structure to write, with levels marked. This is the block most people copy first.
Questions to Answer. The real PAA questions.
Semantic Keyword Cluster. Related terms with importance and, where available, monthly volume. Cover them as concepts; do not repeat them mechanically.
Recommended Formats. The content formats that suit the intent — comparison table, how-to, listicle and so on.
Writing Tips. Specific guidance for this keyword.
30-Day Content Plan. Week-by-week actions.
Recommended Action Plan. The ordered next steps.
What to do with it. Take Target Words, Recommended Headings and Questions to Answer into the draft, then run the published page through Content Optimizer and compare its score against the brief's targets.
Examples#
Example: You run Content Template on how to start a podcast. The header reads Brief score 84/100. The tiles say 2,400 target words at an Intermediate reading level, difficulty 47 (plan link-building), 10 top competitors and 12 PAA questions. Live Metrics shows 33,000 monthly searches and a $1.10 average CPC, so the intent is informational with light commercial pull. Recommended Headings gives 9 H2s; Questions to Answer supplies 12 more sections' worth of material. You export the brief, hand it over, and set the definition of done at 2,400 words with all 12 questions answered.
Screenshots#
Tips#
- Run
Content Templatewhen you want a spec,SEO Briefwhen you want a document to hand to a person. - Read the
Difficultytile before anything else. It decides whether the rest of the brief is worth acting on. - Use
Export Briefrather than copying blocks by hand — it captures the competitors, headings, semantic keywords, questions, formats, tips and plan in one Markdown file. - If the brief score is low, the keyword is probably too narrow. Broaden it and re-run.
- The PAA questions make better H2s than anything you will invent.
Best Practices#
- Brief before you write, always. A brief costs 1 credit; a rewrite costs a week.
- Cover every question in
Questions to Answer, then stop. Length past the target adds nothing. - Treat
Semantic Keyword Clusteras a topic checklist, not a density quota. - Pair with Topic Map when you are planning a cluster of pages rather than a single one.
- Re-brief a page before a major refresh — the SERP will have moved.
Common Mistakes#
- Entering a domain instead of a keyword. Both tabs are keyword tools; a bare domain produces a brief for whatever word is left after the extension is stripped.
- Running both tabs on the same keyword by reflex. That is two credits for overlapping output. Pick the one you will actually use.
- Writing to the word target and ignoring the questions. The questions are what the ranking pages answer.
- Assuming
Save to Hubon Content Template is a server-side save. It stores the brief in that browser only.
Limitations#
- Keyword suggestions, difficulty and the SERP all come from Google's United States, English-language index. The country picker does not change the market.
- The SERP is read to a depth of 30 results, and the top ten are used for the competitor blocks.
- Related keywords are capped at 30, so the semantic cluster is a strong sample, not the full topic.
- The write-up is model-generated on top of real data. Numbers such as volume, difficulty, CPC and the competitor list are measured; the prose is not.
- Neither tab reads your own page. To score existing content use Content Optimizer.
Save to Hubon the Content Template result is stored in local browser storage, so it does not follow you to another device.- Per-tool cache-lifetime overrides do not bind to these tools, because they share one grounding fetcher with the other content tools.
Troubleshooting#
| Symptom | Likely cause | Fix |
|---|---|---|
Enter a value first. | Empty field | Type a keyword |
Please sign in to run this tool. | Signed out | Sign in and run again |
This tool needs a paid plan… | Free plan | Upgrade — see Plans and pricing |
No brief could be generated for … yet. Try a clearer, more specific topic or keyword. | The keyword returned no usable grounding | Use a real search phrase rather than a brand slogan or a sentence |
Competing Pages shows — | The SERP read returned nothing usable | Re-run, or check the keyword is a phrase people search |
| Brief score under 50 | Thin keyword data | Broaden the keyword and re-run |
Try sample runs the tool with an empty field | On this view the sample button triggers a run rather than filling in an example | Type a keyword first |
| Tab switch loses the previous result | Each tab is its own view with its own result area | Switch back — the earlier result is still there |
Hourly fair-use limit reached… | Over 100 light-tool calls this hour | Wait for the hourly reset |
FAQs#
What is the difference between the two tabs? SEO Brief is a hand-off document — title options, meta snippet, outline, on-page targets, competitors and strategy notes. Content Template is an on-page specification with a scored brief, live keyword metrics, a semantic cluster, a 30-day plan and a one-click hand-off to the article writer. Both cost 1 credit and read the same SERP.
Where does the target word count come from? From the pages ranking for your keyword, read live, combined with the intent and difficulty of the term. It is a target to match the winning pages, not a minimum to exceed.
Is the difficulty score the same one used elsewhere in Metric Vault? Yes — it is the same measured keyword-difficulty value used by the keyword tools, so a brief and a keyword report will agree.
Why is this only 1 credit when Keyword Overview is 3? Credits track backend cost. A brief makes fewer and cheaper provider calls than a full single-keyword deep dive. See How credits work.
Can I go straight from a brief to a finished draft? Yes. Generate Full Article on the Content Template result opens AI Article Generator on its Full Article Writer tab with the keyword filled in and runs it, for one more credit.
Can I export the brief? Yes. Export Brief produces a Markdown file, and the export row above the tool offers Export PDF, Export Excel, Export CSV, Export JSON and Share public link. See Exporting results.
See also
Was this article helpful?
Thanks — feedback noted for the docs team.