Skip to content

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?

  1. Open the piece in the Editorial plan (its title or the pencil).
  2. 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.
  3. In a few seconds the brief appears in the text box. Change it as much as you like and click Save brief.
  4. 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:

DataWhere it comes from
The main query and the secondary ones, their intent and the type of pieceThe piece’s record and the query bank
What its sibling pages already coverThe published pages and the planned pieces in the same cluster, with their title, their H1 and their query: so as to stand apart
The competitorsThe 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 linksThe 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 vetoesThe 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?

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?

Back to search visibility.

More about Search positioning