Writing a new record
On this page
This page covers writing a new record with Ghostwriter, from choosing what to write to putting the draft into the form. To change a record that already exists, see Editing an existing record.
Starting
Open a resource's Create page and click Write with Ghostwriter at the top. It's the main part of the Ghostwriter button, with the Ghostwriter mark. Or click Write with Ghostwriter on its list page, if you've added it there. The button shows on the Create pages of the resources Ghostwriter writes for, once the trait is added, for people allowed to use Ghostwriter.
On an existing record's Edit page, the button is Edit with Ghostwriter. See Editing an existing record.
You can also start from Ghostwriter's own pages: Write beside a resource on the Overview, Write something on the widget, the last step of Get started, or Draft this on an idea in the content plan. Each opens the Create page with Ghostwriter already open.
Ghostwriter opens in a large panel over the form. The form stays where it is underneath.
What are you writing?
Choose what this record is:

- From the content plan, shown first: an idea on the content plan for this resource. Its kind is chosen and Ghostwriter fills in the brief from the idea straight away, so the brief card arrives ready to check.
- A kind you taught it, such as "Case study". Its brief has that kind's own questions, and the record is modelled on that kind's examples, which the brief card shows ticked under Model it on. See Kinds of content.
- Something like what is already here: groups of records built the same way (the same Builder blocks), found from the resource's own records, such as "Like About, Services and 3 more". Choosing one starts the general brief, modelled on those records. Hover to see which records they are. Shown only when a resource holds more than one shape of record.
- Something else: a general brief for anything. On the brief card, tick up to six records to model it on, or leave them all unticked to let Ghostwriter choose the shape.
Teach a kind, beside the heading, opens the kinds page for this resource, for something you write often.
Below these, Or carry on with lists the pieces on this resource whose record isn't saved yet, with their kind. With shared conversations on (the default) that's everyone's pieces, with who started each; otherwise only yours. One already put into the form says so ("in the form, not saved").
The brief
Once you've chosen, the conversation opens and Ghostwriter asks for the quick details in one message: "What’s it called, and what should it say? A line or two is plenty." The cursor is already in the answer box. Reply with a working title and a few notes, and press ⌘↵ (or Ctrl+↵) or click Send.
Without a voice guide, a notice says Ghostwriter will still write, but in a plain voice rather than yours, with a link to write the guide.
From your reply, Ghostwriter fills in the whole brief for that kind (one model call; "Filling in the brief…" shows meanwhile) and puts it in the conversation as the brief card:
- Working title.
- Every question the kind asks, with its answer.
- Model it on: the records to follow, ticked and listed first: a taught kind's own examples, or otherwise up to six published records Ghostwriter chose as closest in purpose and shape to the new piece. Change them for this piece if you like, up to six; once six are ticked, the rest can't be ticked until you untick one. Try again keeps what's ticked.


Ghostwriter proposes the angle, the reader, the structure and the length. It never makes up facts about your organisation: anything only you know (a figure, a quote, a name) is left in [square brackets] for you, and the card says so. Change any answer on the card, then:
- Looks right, start writing stores the brief on the piece and starts the writing. Something still in
[square brackets]is fine: Ghostwriter asks about it, or leaves it as a gap for you to finish. A required question left empty is pointed out first. - Try again fills in the brief afresh from the same details. Answers you changed are kept exactly as you wrote them.
Pressing Enter on the card never starts writing: only Looks right, start writing does.
Draft this on an idea in the content plan skips the question: the card arrives already filled in from the idea, ready to check.
Screen readers hear "The brief is filled in. Check it, then start writing." when the card arrives. The card is a labelled region ("Brief"), and every answer is labelled with its question.
Ghostwriter uses only facts from the brief and the conversation. It doesn't invent figures, quotes or client names. Where it needs something it doesn't have, it asks, or leaves a
[note in square brackets]for you.
The conversation
Once you agree the brief, the card folds away to Show the brief. Click it (or press Enter on it) to open the brief again: it's still editable, and Save the brief keeps your changes. Nothing is rewritten then; Ghostwriter works from the changed brief from your next message. It can't be saved while Ghostwriter is working.
While Ghostwriter works, the button you pressed stays down and spins, and a line says what it's probably doing ("Reading the brief…", "Thinking it through…", "Writing. Long drafts take a while…"; "Revising the draft…" for a change) with a timer, and screen readers announce it.
If Ghostwriter needs facts only you know before it can write, it asks first: four short questions at most, headed Ghostwriter needs your answer and announced to screen readers. Each question has its own box, labelled with the question, with a hint under it when one helps; a question with a few set answers has radio buttons instead, and one it can do without is marked optional. Skip a question you can't answer: Ghostwriter writes around it or marks the place for you to fill in. Add anything else opens a box for anything more. Send answers (or ⌘↵ / Ctrl+↵ in any box) sends them all as one message; Just draft it with what you have has it write now and mark the gaps in [square brackets]. Once sent, the questions stay in the conversation with your answers under them.

Ghostwriter's replies are shown with their formatting: lists, bold and links.
Once there is a draft, ask for changes in plain words:
- "Make the opening shorter."
- "Add a section on cost, after the process."
- "Less formal."
Press ⌘↵ (or Ctrl+↵) to send, or click Send. A draft usually takes a minute or two. Show the brief, in the conversation, shows the brief it's working from.
Each draft adds a line to the conversation, such as "Draft written · 232 words" or "Draft updated · 240 words".
The draft
The draft sits on the right, laid out the way the form is built: its fields, and any Builder blocks or Repeater rows in order.
- Blocks / Text switches between the full layout and just the words.
- Change any writing where it's shown. The draft says "Click any writing (or Tab to it) to change it. It's saved when you leave it; Esc puts it back." Click it, or press Tab to reach it, and type. It's saved when you leave it (click elsewhere or press Tab). Esc puts it back as it was, and Enter finishes a one-line piece such as a title. Rich text is edited as rich text: ⌘B/Ctrl+B and the like work, and pasted formatting is kept as headings, lists, bold, italics and links.
- Edit YAML opens the whole draft as text, to add, move or remove blocks. Most people never need it.
While Ghostwriter is working, the draft can't be changed: the writing isn't editable, and Edit YAML is off until it finishes, since what it writes would replace the change.
If a draft can't be read (for example after a YAML edit that broke it), the YAML editor opens by itself with the problem above it, so you can put it right and save.
The word count is shown at the top. A block type the resource doesn't have is flagged, and left out when the draft is used. A block with nothing to write says "Uses its usual settings."
Headings follow the page: the body starts at H2 under the title, levels never skip, and each RichEditor gets only the heading levels its toolbar offers. See Headings.
On a screen narrower than 1024px, the conversation and the draft stack, and the whole panel scrolls as one, with the draft's bar staying at its top.

The panel follows the panel's dark mode.

Links to your pages
If your resources have public addresses, a new piece's first draft is linked to a few of your other pages. While Ghostwriter picks them, the draft is there to read and the pane says "Draft ready. Checking headings and links…"; Use this draft, Edit YAML and changing writing in place wait until it's done. A line under the draft in the conversation says what was linked ("I linked to 2 of your pages: …").
In the draft, each link Ghostwriter added has a dotted underline and a small mark, and a line above the draft says so. Hover over it, focus it or click it to see the page it goes to and why, with Open page and Remove link. Removing a link keeps its words, and Ghostwriter won't put it back.

Search title, description and address
If the form has an SEO title or description field, or a slug field, the draft comes with how the page may appear in search results. In Text view it's the Search section under the writing; in Blocks view it's a folded Search row above the blocks. Nothing in it goes into the form until Use this draft.
- SEO title. While the page title fits search results, the SEO title keeps using it, as most sites do: "Uses the page title: “Winter garden care”", greyed, with Give it its own, which opens the title to edit; left as it was, it goes back to using the page title. A page title too long for search results gets a shorter title of its own. Use the page title goes back.
- Meta description. One plain sentence or two, from what the page says and nothing else, 120 to 155 characters for the usual limit of 160 (the field's
maxLengthotherwise). The count beside it (149 / 160) follows your typing and turns amber outside that range; hover it for the range. If the record already has a description of its own, it stays: "Your SEO description stays. Suggested instead: …", with Use this if you'd rather have Ghostwriter's. A description shown from its fallback field that fits is left as it is. - Address. The slug, made from the title without the little words ("prune-walled-garden-winter"), at most five words, and kept clear of the slugs already in use. It's set on a new record only: published pages keep their address, so on an Edit page it's shown greyed.
- Change any of them where they're shown, as the writing: saved when you leave it, Esc puts it back, Enter finishes it. What you write is yours: a later turn won't rewrite it.
- Try again asks for another title and description. It uses Ghostwriter (one small request), and says "Writing another…" while it does.
When you ask for changes and the title changes, or about a quarter of the words, Ghostwriter writes the title and description again, except any you wrote yourself.
Use this draft
Use this draft puts the draft into the form and closes the panel.
- Nothing is saved. The form is filled in, just as if you had typed it. Check it over, then click Create as usual, or leave the page to throw it away.
- The SEO title and description go into their fields where they're empty, or still hold what Ghostwriter wrote before. A description someone wrote is never replaced: Ghostwriter's is offered in Finish this page instead. On a new record, the address goes into the slug field too, unless someone typed one.
- Using it again replaces what is in the form.
- Opening the panel again carries on with the same piece, with a line saying it's already in the form.
A notification says "Draft added to the form. Check it over, then save." If there's anything still for you to do, it lists it, and stays until you close it. If anything is left to finish (a fact to add, a link to choose, an image placeholder), Finish this page opens by itself to take you through it. The notification lists, for example:
- Fields it leaves for a person: relationships, dates, uploads, anything switched off.
- Settings that differ from record to record, which it couldn't copy from the house style.
- Image fields marked with a striped placeholder, where the resource's records usually have a picture. Replace them with the image button.
- The record starts unpublished, if the plugin has
->unpublishWith(): "Ghostwriter drafts start unpublished. Switch it on when you're ready."

Carrying on later
The conversation is saved as you go. Close the panel and open it again on the same page, and it carries on with the last piece you were on. The page's address names the piece, so a reload reopens it too. Coming back to the Create page later, choose it under Or carry on with, click it under Carry on on the Overview, or click Resume on its idea in the content plan.
Start over goes back to What are you writing?, and the panel opens there next time. The earlier piece isn't deleted; it is still offered under Or carry on with. (A piece you never replied to isn't kept.)
A piece carried on, or a colleague's shared piece, shows the brief card in the conversation as it stands: waiting to be checked, or folded away to Show the brief. Pieces started before the brief card show their brief behind Show the brief as before.
A piece leaves In progress once its record is saved. A draft put into the form and left unsaved is still listed, under Or carry on with and Carry on.
Sharing conversations
Conversations are shared with everyone who may use Ghostwriter, so a colleague can pick a piece up where you left it. Each message shows who sent it, and the panel says who started the piece and who last changed it. See Shared conversations.