Finish this page
On this page
Some things in an entry only a person can finish. Ghostwriter finds them, and it won't let the page go live until they're done.
- Facts to add. Ghostwriter never invents a price, a date, a duration, a name or a quote. Where a draft needs one it doesn't have, it marks the place:
Tickets cost [[ask: adult ticket price]] for adults. - Links to choose. A link whose page Ghostwriter doesn't know keeps its words, and points at
#gw-link:with a hint:[Talk to us](#gw-link:contact-page). A Link or Hyper field it can't settle holdshttps://example.com/#gw-link:<hint>with the text "Link to choose". - Counts to check. A number Ghostwriter worked out from a list you gave it ("3 counties" from "Northumberland, Durham and Cumbria") is counted by Ghostwriter, never the model, and marked for you to confirm:
Gardens across [[check: 3 counties | from: Northumberland, Durham and Cumbria]]. See Counts to check. - Images to choose. The striped placeholder in an image field, and a stock photo preview not licensed yet.
It also notices links to entries that have been deleted, template text such as [[item]] left in a sentence, an empty image the page looks like it needs, and placeholder words such as "TBC". A required text, date or dropdown field left empty is Craft's to report when you save.
Finding them never calls a model. It works on any entry in a section Ghostwriter writes for, whoever wrote it.

The guide
On an entry with something that stops publishing, or an empty image the page needs, a count sits on the menu beside Edit with Ghostwriter, in amber: "8". The menu lists Finish this page with the same count (and Review suggestions with its own, where there are any). Each field with a gap is outlined, with a numbered tag beside its name ("3 · Needs a link"; "4–7 · 4 to do" for a field with several); inside CKEditor the words themselves are marked. A plain text box (a Plain Text field, or a cell of a Table field) can't mark part of its text, so one holding a gap gets a row of small chips under it, one per gap: "Add: years trading", "Check: 3", "Choose a link: contact page". The field keeps its outline and tag. The chips follow your typing, and they're never part of the value.

Choose Finish this page in the menu, or click a tag, to open the guide in the corner. It takes you through each one, the things to finish first ("2 of 8") and then any suggestions ("Suggestion 1 of 1"), which never stop the page going live:
-
The step: what's missing, and where, in plain words. "I left a gap in the Text block: starting price. Only you know this. What should it say?"
-
The fixes, the most likely first:
What Fixes A fact to add A box to type it into: Enter, or leaving the box, puts it in the field in place of the marker; Esc leaves it. Write around it rewrites the sentence without the fact. Ghostwriter never suggests the fact itself. A count to check Looks right (the count goes in as the page will say it), Change it (a box with the count, to correct), or Remove it. When the list has changed since, Use “4 counties” first A link to choose Link to Contact us first, where Ghostwriter suggested a page for a link the writer left (checked by a second look, never put in for you); Link to Contact where an entry's title or slug matches the hint (the suggested page isn't repeated), Choose an entry (Craft's own picker), or Remove the link (the words stay) An image placeholder Find a photo (Ghostwriter's image dialog for that field), Choose from Assets (the field's own picker, replacing the placeholder), or Leave it empty when the field isn't required An empty image the page needs The step says why ("Hero image is required. Add one?", "Hero image is empty, but most Journal entries have one. Add one?"), then Find a photo or Choose from Assets A stock photo preview License, through the stock photos' own License & replace dialog, which shows what it costs; Request licence without the permission; Choose another A field pages like this usually fill Write it for me (a line from the page's own text) for writing fields, or I'll write it Template text, "TBC" Remove it, I'll write it, or It's fine for a suggestion A link Ghostwriter added A suggestion for each link it added to a first draft: "Check the link Ghostwriter added. “tell us about your garden” goes to Contact (/contact). Keep it, or remove the link and keep the words." Keep it, or Remove the link (the words stay; in CKEditor it's undoable) An SEO title or description too long "SEO description is too long." I'll write it takes you to the field Add a description for search A suggestion when the SEO description is empty or too short: "The SEO description is empty, so search engines will pick their own. Here's the one from the draft: “…”" Use this puts the draft's description into the field (in SEOmatic, with its Override switch on and its source custom text); I'll write it takes you to the field Shorten a heading A suggestion for a heading over 70 characters, which is hard to scan and cut off in search results. Write it for me asks Ghostwriter for a shorter one with the same meaning (one small call, queued, and the button says so); only the heading's words change in CKEditor. I'll write it selects the heading Link to your other pages A suggestion for a page of 300 words or more with no link to the site's own pages (a reference tag, a path such as /contact, or a full address on your site; links to other sites don't count). Suggest links (uses Ghostwriter: two calls, in the queue; the button says "Finding pages to link to…" meanwhile) reads the entry as the form has it and looks for a few of your published pages to link to, by a first draft's rules: about one link per 250 words, two to five, on descriptive words, never in a heading, spread through the page. Each link it finds is a step of its own, Link “…” to Contact us?: Link it links those words in CKEditor (nested entries too; Undo takes it back, and Craft saves the draft as it does for any typing) or Skip. If no page is close enough, the step says so. Add a link takes you to the text; Skip hides it. Suggest edits can propose links too
Write it for me and Write around it each make one small request to your AI provider, and say so on the button ("uses Ghostwriter"). Nothing else in the guide calls a model.
-
Back, Skip for now and Next. Skipped gaps stay highlighted and still count; the guide remembers them for this entry for the rest of the browser session.
Every fix goes into the form, as if you had typed it, and counts only once the field really holds something new: if it doesn't, the guide says so and stays on the step. Cancelling Craft's picker leaves the field as it was. While a picker, a dialog or a block's slideout is open, the guide steps aside. Craft saves your draft as it always does, and nothing is published until you save.
The guide looks again each time Craft saves your draft, and only what it finds then is still a step. A field turns green ("Fixed ✓") once it had gaps and has none left; when a fix leaves something else in the same field (a placeholder swapped for a stock preview, which still needs a licence), that's a new step and the field stays open.
The Ghostwriter mark flies to each step with a short label ("Fill this in", "Needs a link", "Swap me", "License me"). For words in CKEditor (a fact to add, a count, a link to choose or a broken link, template text, placeholder words) it lands just above the words themselves, or below them when Craft's header or the editor's toolbar leaves no room; the words are scrolled to the middle of the editor and tinted for a moment. Anything else, or words it can't find, gets the mark just past the field's tag. The label goes on whichever side of the mark covers no text and stays inside the window, so it never hides what you're reading. Where every side would cover text, the label is hidden and the mark points on its own. Minimise the guide with — (or Esc inside it) and it folds into the mark in the corner, with the count; click it to bring the guide back. Each person's choice, open or minimised, is remembered on every entry. After Use this draft, the guide opens by itself (Open the guide after a draft is added).
A block in a page builder that's collapsed is expanded when its step comes up, and the right tab is opened. In a Matrix field shown as cards, the card carries the highlight, and Open block opens it in Craft's slideout, where its fields are highlighted too.
The search steps, and the rest of the SEO wording, are in German, French, Dutch and Spanish as well as English (src/translations/{de,fr,nl,es}/ghostwriter.php, from core by php bin/sync-core-strings).
Keyboard and screen readers
| Keys | |
|---|---|
| Alt+Shift+N / Alt+Shift+P | The next step, the one before |
| Alt+Shift+G | Open or minimise the guide |
| Esc, inside the guide | Minimise it |
The shortcuts work whenever you aren't typing in a field. The guide is a labelled region, not a dialog, so the form stays usable around it; each step, fix and change is announced politely. Tags are buttons ("Gap 4 of 9: Fill this in").
Phones and motion
Below 640px wide, the guide is a sheet along the bottom of the screen, which folds to a single line ("4 of 9 · Fill this in · Next"); the flying mark is left out. With your system set to reduce motion, nothing flies, bobs or folds: the guide and the mark simply appear.
What counts
| What | How it's found | Stops publishing |
|---|---|---|
| A fact to add | [[ask: …]] in any text |
Yes |
| A fact for a number or date field | The draft asked for it, and the field is still empty | Yes, if the field is required |
| A count to check | [[check: 3 counties | from: …]] in any text |
Yes |
| A link to choose | A link to #gw-link:… (also as CKEditor keeps it, #gw-link:Winter%20structure), or a Link or Hyper field holding https://example.com/#gw-link:… |
Yes |
| A link to a deleted entry | Its {entry:…} reference points at nothing |
Yes |
| An image placeholder | The striped ghostwriter-image-placeholder.png in an image field, or inline in CKEditor |
Yes |
| A stock photo preview | The stock ledger says it isn't licensed. See Stock photos | Yes |
| Template text | [[item]], a word in double brackets with no colon |
Yes |
| An empty image the page needs | Required; the page's hero (the block the template prints the H1 from, or a hero image when the section has too few live entries to go by); or filled on at least 70% of the section's 20 newest live entries of the type. Not on a new entry until a draft is put in or it has some text | No: it's counted and brings the guide out; Craft enforces required |
| A required field left empty | Craft's own Required | Craft stops it, so it isn't listed |
| A field pages like this usually fill | Filled on at least half the section's live entries | No, a suggestion |
| A link Ghostwriter added | A link a first draft got to one of your pages, still in the entry | No, a suggestion |
| An SEO title or description too long | Over the field's limit (SEOmatic's usual 60 and 160, or a Plain Text field's character limit) | No, a suggestion |
| Add a description for search | The SEO description (SEOmatic's, or a seoDescription or metaDescription Plain Text field) is empty or under about 120 characters, on a page someone has worked on. One that comes from another field that fits, a template, or a switched-off setting is left |
No, a suggestion |
| Shorten a heading | A heading in CKEditor over 70 characters | No, a suggestion |
| Link to your other pages | 300 words or more, and no link to the site's own pages | No, a suggestion |
| Placeholder words | TBC, TBD, TBA, TODO, XXX, [insert …], [add …], [check …], lorem ipsum |
No, a suggestion |
In sections Ghostwriter doesn't write for, only stock photo previews are looked for.
Counts to check
When the writer prepares an extra such as "Gardens across 3 counties" from a list in your brief, answers or the draft, Ghostwriter counts the list itself: commas with a final "and" or "or", or bullet points. Open lists ("such as", "etc."), ranges and prose are never counted. Whatever number the model proposed, the one that goes in is Ghostwriter's, marked to check: the extras list in the writing panel shows it as Counted from your brief: “…” and Needs review.
The step says "I counted 3 counties from “Northumberland, Durham and Cumbria”. Is that right?", with the mark saying "Check me".
- Looks right puts the count in as the page will say it ("Gardens across 3 counties").
- Change it opens a box with the count in it; Enter, or leaving the box, puts your words in.
- Remove it takes the count out.
- If the list has changed since (you changed your answer, or the draft), the step says so: "…but that list has changed since. It now has 4. Use “4 counties” instead?", with Use “4 counties” first. If the list isn't in what you gave Ghostwriter any more, it asks whether the count is still right, with Change it first. A count edited by hand so it no longer matches its list is offered back as the list's count.
Like a fact to add, a count to check stops the page going live until it's resolved.
Publishing
While anything that stops publishing is left, saving the live entry is refused, with a message on each field:
Add adult ticket price before publishing.
Inside a Matrix or Neo block, the message names the block and field: "Hero: Intro: Add adult ticket price before publishing."
- Applying a draft to a live entry is checked the same way, and so is Create entry on a new one (Craft 5.9 and later), with the messages on the draft's fields.
- Drafts always save, provisional drafts included, and so does a disabled entry. New entries Ghostwriter writes start disabled (see Use this draft).
- Only saves in the control panel are checked. Console commands (
php craft resave/entries, migrations, imports), queued jobs and the front end always save. In sections Ghostwriter doesn't write for, only an unlicensed stock preview stops publishing. - Ghostwriter never takes a marker out for you. Removing
[[ask: …]]from "Tickets cost [[ask: adult ticket price]] for adults." would leave "Tickets cost for adults."
To publish anyway and be told what's left, set Settings → Ghostwriter → Finish this page → When a page with things to finish is published to Warn (onUnfinishedPublish = warn). The entry saves with one notice listing everything. Anything still marked goes live as it is: a [[ask: …]] or [[check: …]] shows as written, and a #gw-link: link goes nowhere.
The older stockOnPublish setting is still read when onUnfinishedPublish isn't set.
Settings
| Setting | Config | |
|---|---|---|
| When a page with things to finish is published | onUnfinishedPublish |
block (the default) or warn. |
| Open the guide after a draft is added | finishOpenAfterDraft |
On. |