A piece’s brief
The brief for a piece in the editorial plan is what it has to say to win its Google query without overlapping the other pages on your website: the SEO title, the H1, the meta description, the sections with what each one covers, the questions it has to answer, the internal links with their text and what it should not cover because another page already covers it. The AI prepares it with your website’s data and you change it as you like. It is in Marketing → Search visibility, Editorial plan tab, on each piece’s record.
What is it for?
So that whoever writes the piece —you, someone on the team or an outside author— starts with a clear assignment: which query it targets, which sections it has, which of your pages it has to link to and what it shouldn’t talk about because another page in the same cluster already says it. That way the new piece adds to the cluster instead of competing with its sibling pages.
How do I prepare it?
- Open the piece in the Editorial plan (its title or the pencil).
- At the bottom, in Piece brief, click Prepare brief. Next to it you are told what it costs: 60 AI credits, which are only charged if the brief is saved.
- In a few seconds the brief appears in the text box. Change it as much as you like and click Save brief.
- Copy puts it on the clipboard so you can paste it into WordPress, a document or an email to the author.
What data does the AI prepare it with?
With data from your website, chosen by the ERP, never made up:
| Data | Where it comes from |
|---|---|
| The main query and the secondary ones, their intent and the type of piece | The piece’s record and the query bank |
| What its sibling pages already cover | The published pages and the planned pieces in the same cluster, with their title, their H1 and their query: so as to stand apart |
| The competitors | The top ten Google results for the main query, if you have their snapshot (real search data); those from your own website don’t count |
| The required links | The cluster’s pillar (the pillar page or, if it isn’t published yet, the pillar piece) and the sibling pages most similar to the piece in meaning |
| Marketing’s notes and vetoes | The guidelines in force: the general notes, those for the topic, those for the cluster and those for the piece’s query, and everything vetoed |
How many sibling pages are required is set in Guidelines → SEO weights and thresholds → Internal linking and brief (by default, 2).
What does the AI never do?
- It doesn’t make up figures. No searches per month, Google positions, prices, percentages or years that aren’t in the piece’s data. Anything that brings a figure not in the data is discarded entirely; if what is discarded is the SEO title or the H1, the piece’s title is kept.
- It doesn’t talk about what is vetoed. Anything containing something marketing has vetoed is discarded.
- It doesn’t link to what doesn’t exist. Links only go to published pages on your website or to pieces in the plan; the required ones are always included, even if the AI doesn’t add them.
Below the brief, The AI suggested N things that were not used says what was discarded and why.
And if the piece changes afterwards?
The brief was made with certain data: the piece’s main and secondary queries, its cluster and its sibling pages. If any of them changes afterwards —you give it another query, you move it to another cluster, a sibling page is created or published—, the record warns you: ‘This outline predates a change in the piece’. The brief stays there, as it is; Prepare again makes it with the current data (and costs again). If you changed it by hand, it asks you first, as always.
The brief’s labels (‘SEO title’, ‘Sections’, ‘Internal links’…) are shown in the language of whoever is looking at it, not of whoever prepared it. What the AI writes (the titles, the sections) is in the piece’s language. If you change it by hand, it stays exactly as you wrote it.
And if I change it by hand?
What you write wins. As soon as you save a change, the brief is marked as changed by hand, and clicking Prepare again doesn’t overwrite it: it asks you first. Yes, replace it prepares it again (and costs again); No, keep mine leaves it as it is. Without confirming, nothing is requested from the AI and nothing is charged.
Can I ask the assistant to do it?
Yes. ‘Prepare the brief for the verifactu article in the editorial plan’ or ‘which sections and internal links should the time tracking piece have’ prepare the brief with the same action as the record, and use the same credits. Like every assistant action, it shows it to you before doing it. If the brief has been changed by hand, it doesn’t replace it unless you tell it to.
What permissions are needed?
To see the brief, View on Search visibility. To prepare or change it, Changes.
What doesn’t the brief do?
- It needs the platform’s AI and AI credits. Without them, the brief can still be written by hand.
- Without a snapshot of the Google results for the main query, the brief is prepared without looking at the competitors, and the warning says so.
- The sibling pages are those in the piece’s cluster: a piece without a cluster has no sibling pages or pillar, and the brief only links to pages with similar titles.
- The brief doesn’t write anything to your website: it is a text for whoever writes the piece.
Back to search visibility.
More about Search positioning
- Guest posts
- Proposed clusters
- Connect your website with Google: Search Console and Analytics
- Query real search data: what it costs
- Cross-checks between SEO and ads
- Add your website and test the connection
- Search data: volume, difficulty and Google results
- Marketing guidelines: what marketing tells the plan
- The editorial calendar
- The content map: what each page of your website targets
- The Looker Studio dashboard: your content map alongside what Google measures
- The editorial plan