Finish this page
A draft can't know everything. Ghostwriter never invents a price, a date, a duration or a name. It leaves a mark where only you know the answer. Finish this page finds everything still unfinished on a record, highlights it in the form, and takes you through it one field at a time. A record can't be published until the gaps that matter are finished.
It works on any record of a resource Ghostwriter writes for, whoever wrote it. Finding gaps never asks a model and costs nothing.

What it finds
| Gap | What it is | Counts | Blocks publishing |
|---|---|---|---|
| A fact to add | [[ask: adult ticket price]] in any text: a fact only you know |
✓ | ✓ |
| A count to check | [[check: 3 areas | from: …]]: a number Ghostwriter counted from a list you gave it. "I counted 3 areas from “Northumberland, Durham and the Tyne Valley”. Is that right?" |
✓ | ✓ |
| A fact for a number or date field | The writer wanted to ask for it, and the field is still empty | ✓ | ✓ |
| A link to choose | A link to #gw-link:contact-page in a RichEditor or Markdown field: the words are there, the address isn't |
✓ | ✓ |
| Leftover template text | [[item]] and the like, from a prompt override with a typo |
✓ | ✓ |
| An image placeholder | Ghostwriter's striped placeholder, in an upload field or inline in a RichEditor | ✓ | ✓ |
| A stock preview | A paid stock photo put in as a preview but not licensed (Stock photos) | ✓ | ✓ |
| An empty image the page needs | Required; the page's hero (a field named for it, such as Cover or Hero image, when there are too few published records to go by); or filled on at least 70% of the 20 newest published records. The step says why: "Cover is empty, but most Post entries have one. Add one?" It brings the guide out, but not on a new record until a draft is put in or it has some text | ✓ | |
| An empty SEO description | The SEO description is empty, or shorter than search results have room for (under 120 characters for 160), on a page someone has worked on. "Add a description for search": "The SEO description is empty, so search engines will pick their own. Here's the one from the draft: “…”" | suggestion | |
| A long heading | A heading in a RichEditor or Markdown field over 70 characters, hard to scan and cut off in search results. "Shorten a heading": Write it for me asks Ghostwriter for a shorter one with the same meaning (one request, and the button says so) and changes only the heading's words; I'll write it selects it | suggestion | |
| No links to your other pages | A page of 300 words or more with no link to the site's own pages (a path, or an address on the app's host; links to other sites don't count). "Link to your other pages": Suggest links (uses Ghostwriter: two calls; the button says "Finding pages to link to…" meanwhile) looks for a few of the app's public pages to link to (resources with ->publicUrlUsing()), 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 the RichEditor (Undo takes it back; nothing is saved until you save) 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 |
suggestion | |
| A link Ghostwriter added | A link to one of your pages that Ghostwriter put in a new draft (Links to your pages): "Check the link Ghostwriter added. “…” goes to Contact us (/contact)" | suggestion | |
| A usually-filled field | Empty prose that most records like this fill in (a summary) | suggestion | |
| Placeholder-looking text | TBC, TBD, [insert …], lorem ipsum |
suggestion |
An empty required text, date or select field isn't listed: Filament's own validation stops the save.
"Counts" is what the menu counts. Suggestions are listed after the steps, numbered on their own, and never block anything.
The markers are visible on purpose: someone who never opens the guide still sees [[ask: …]] in the text. The keywords ask and gw-link are never translated.
The guide
- The count, on the chevron of the Ghostwriter button in the page header: one badge with how many things are left to finish plus any suggestions to review (amber while anything is left to finish; grey when there are only suggestions; none at 0). The menu lists Finish this page with its count, which opens the guide, and Review suggestions with theirs, each only while its count isn't 0. On a new or finished record with nothing that blocks publishing, there is no count. An empty image the page needs counts too, and brings the count and the dock out when the page opens.
- Highlighted fields: amber for what's left, the guide's colour for the current step, and green once finished in this view. A tag beside the field's name says which step it is and what kind ("2 · Swap me"), or, for a field with several, the range ("2–4 · 3 to do"). Click a tag to go to that step.
- Inside a RichEditor, the marker's own words get a dashed underline: the fact to add, the link's words, the template token.
- The guide, bottom right, has the message, the fixes, and Back · Skip for now · Next. It opens the field's tab, section, or collapsed Builder or Repeater item, and scrolls it into view clear of the guide.
- The flying mark goes to each step with a short label ("Fill this in", "Needs a link", "Swap me", "License me"). For a fact to add, a link or leftover template text in a rich editor (and a suggested edit), it sits at the words themselves, just above them (below, where the topbar or the editor's toolbar leaves no room), and the words are scrolled to the middle and tinted for a moment. Otherwise it sits beside the field. It never covers Filament's topbar or a stuck editor toolbar, and its label goes on a side where it covers none of the page's text and stays inside the window. Where every side would cover text, the label is hidden and the mark points on its own.
- Minimise (the —, or Esc inside the guide) folds it into the corner dock with a count badge. Whether it was open or minimised is remembered for you, on every record. It starts minimised, and opens by itself after you use a draft (
ghostwriter.finish.open_after_draft).
While one of Filament's dialogs is open (Find a photo, License), the guide steps aside. A fix counts only when it really changed the field; if it didn't, the guide says so and stays on the step.
Moving between steps, minimising and restoring all happen in the browser: they never send the form to the server, so file uploads and editors are left alone. Only a fix that changes a field writes into the form.
Fixes
| Fix | What it does |
|---|---|
| Type it in (a fact) | A box in the guide: Enter, or leaving it, puts your answer in place of the marker; Esc puts it back. |
| Link to Contact us (a link) | Shown first when Ghostwriter suggested a page for the link: the page it most likely means, picked when the draft was linked and checked a second time. One click links the words; it's never put in for you. |
| Add the address (a link) | Points the link at what you type: /contact or a full address. |
| Remove the link | Keeps the words, drops the link. |
| Keep it (a link Ghostwriter added) | Leaves the link as it is. |
| Use this (an SEO description) | Puts the draft's description into the field. Free: it was written with the draft. |
| Looks right / Use “4 areas” / Change it (a count) | Puts the count in as it is, takes the new count where the list has changed since, or opens it to edit. |
| Remove it (template text) | Deletes the token. |
| Find a photo | Opens the field's own Ghostwriter image dialog. |
| Upload an image | Opens the field's own file picker, even when the placeholder fills it. |
| Leave it empty | Takes the placeholder out, where the field isn't required. |
| License / Request licence | Opens the stock badge's own License dialog (its confirm and its cost), or asks a manager. |
| I'll write it | Puts the cursor in the field, with the marker selected so typing replaces it. |
| Write it for me (uses Ghostwriter) | One small request: a line for an empty summary-like field, from the page's own text. |
| Write around it (uses Ghostwriter) | One small request: the sentence rewritten without the missing fact. It never fills the fact in. |
| It's fine | Skips a suggestion for now. |

Nothing is saved until you press Save. Skip for now is remembered for this record until you close the browser tab; a skipped step still counts and still blocks.
Only the two fixes marked uses Ghostwriter call a model, one small request per click. Ghostwriter refuses to write a fact, and an answer with a figure the page doesn't have is thrown away.
Each fix is one line inside the guide. A long name in its label, such as a record's title, is cut short with an ellipsis; the whole label is the button's tooltip and its name for screen readers.
Keyboard and screen readers
- Alt+Shift+N next, Alt+Shift+P back, Alt+Shift+G open or minimise. These work anywhere on the page except while typing in a field.
- The guide is a labelled region, not a dialog: the form stays usable. Focus moves to the step's message when it opens or moves on, and to the dock when it's minimised. A polite live region says each step and each fix.
- Tags are buttons ("Gap 2 of 5: Needs a link"), and each highlighted field says what it needs.
- Under reduce motion there is no flight, bobbing, peeking or wisps; minimising is an instant swap.
- Dark mode follows Filament's. Below 640px wide the guide is a bottom sheet, and the flying mark is hidden.

Publishing
Filament has no "published" of its own, so the plugin's ->publishedWhen() says what live is:
GhostwriterPlugin::make()
->publishedWhen(fn (Model $record): bool => $record->status === 'published');
- With it, saving a record that will be live while something that blocks is left is refused. Each message is under its own field ("Add the adult ticket price before publishing."), Builder and Repeater items included. Drafts save freely. Required fields are left to Filament's own validation.
- Set to Warn, the record saves, with one warning that lists everything left.
- Without
publishedWhen, nothing is ever refused: each save with something unfinished gets one warning. - Only saves on a resource's Create and Edit pages that use Ghostwriter are checked. Saving a model in code (a seeder, a job, an import, a console command) is never refused.
The rule is Settings → Publishing → When a page is published with something unfinished: Block (the default) or Warn. GHOSTWRITER_PUBLISH_ON_UNFINISHED=block|warn in .env wins over the page. Until the new setting is saved, the older stock photos setting (and GHOSTWRITER_STOCK_ON_PUBLISH) is still read.
The same guard covers unlicensed stock previews, so a preview and a marker give one refusal with both.
In Warn mode, [[ask: …]] text goes live as it is. That's the price of warning instead of blocking.
What Filament can't do (yet)
- Link fields. Filament forms have no link fields Ghostwriter knows, so link gaps exist only inside RichEditor and Markdown text. A required URL
TextInputleft empty is Filament's to report. - Choosing a link's page. There are no "Link to …" matches by title, as there are no entries to search. Where a resource has
->publicUrlUsing(), a link to choose that the writer left in a new draft may get one suggested page instead (see Fixes). Otherwise, point it with Add the address. There is no check for links to records since deleted. - An asset browser. Images come from Find a photo or the field's own upload.
For developers
- The menu's count and the guide appear on the Create and Edit pages of the resources Ghostwriter writes for (pages using
WritesWithGhostwriter), for people who may use Ghostwriter. - Every field's wrapper gets
data-gw-path="<state path>"(added to its own attributes withField::configureUsing()). Where an app replaces the wrapper attributes, the guide finds the field by its input's ID. - Every RichEditor gets Ghostwriter's
RichContentPlugin, whose TipTap extension draws the underlines with ProseMirror decorations. It doesn't change the content. - Gaps are found in the form as it is, through the stored form map. After changing a resource's form, run
php artisan ghostwriter:scan. - The guide's own state (open or minimised) is saved with a plain
POSTtoghostwriter/finish-guideon the panel. - A draft's gap list is kept on its session (the
gapscolumn, one of the migrationsghostwriter:installpublishes), so the guide can say why something was left.