Suggest edits and Content to revisit
On this page
Suggest edits reads an existing record against your voice guide and suggests small changes: a past year written as current, a sentence that says one thing in forty words, a count that may have changed, an image without alt text, an SEO description over its limit. You step through them in the Finish this page guide and accept, edit, dismiss or undo each one. Accepted changes go into the form. Nothing is saved until you save.
Content to revisit lists the published records that may need a look, ranked by checks that cost nothing, with a Review button on each.

What it costs
| Action | Model calls |
|---|---|
| Suggest edits (or Review on Content to revisit) | Two: one reviews the page, a second double-checks every suggestion it kept (none when it kept nothing). A long page (over 6,000 words) is read in parts, two calls each, and the confirm says how many before anything runs. Both run on your writing model at high effort, so a review costs roughly twice the tokens of one call |
| Accept, Edit, Another version (the stored ones), Dismiss, Undo, It's still right, Use it | None |
| Write another (after the stored versions) | One small call |
| The free checks, Content to revisit, saving, the scheduled commands | None |
There is no overnight review: a review runs only when someone clicks.
Suggest edits
On a record's Edit page, open the menu on the Ghostwriter button (the chevron beside Edit with Ghostwriter) and choose Suggest edits ("Reads the page against your voice guide, then double-checks each suggestion. Uses Ghostwriter twice."). The confirm says how many calls it will take. The review reads the form as it is now, unsaved typing included, and runs as a queued job.
Nothing reaches you that the model hasn't judged in context. Checks that cost nothing find candidates:
- past years written as current ("New for 2023");
- "this year" or "coming soon" on a page a year old or more;
- closing dates that have passed;
- counts and prices that may have changed ("our team of 6", "from £60"), on pages a year old or more;
- links whose words say nothing ("click here");
- an SEO description that's empty or too short, and a heading over 70 characters;
- a page of 300 words or more with no link to your other pages: the review is shown up to ten pages with a public address it could link to, and proposes links on words already in the page;
- paragraphs much like one on another record of the same resource;
- images without alt text;
- SEO titles and descriptions over their limit.
The review reads each one in its paragraph and keeps it, with a fix that fits its sentence, or drops it ("New for 2023" in a 2023 news post is history, not a mistake). It adds its own: wording that's off-voice or unclear. Then a second call double-checks every suggestion it kept: that it's a real problem here, that the new words read naturally in the sentence, add no fact and sound like you. Only what passes both is shown. While it runs the guide says "Reviewing… then double-checking". What it judged fine isn't mentioned, and stays quiet for 12 months or until its sentence changes.
If the review call fails, nothing is shown and Try again runs it again. If only the double-check fails, the review's own checked suggestions are shown.
The guide
It is the Finish this page guide: the same dock, flying mark and field highlights, in indigo. The open suggestions are counted on the Ghostwriter button's chevron, and its menu's Review suggestions opens the guide on them. When a page has both, the guide has two tabs on a row of their own, Suggested edits and Finish this page, each with its count.
- Filters by kind ("All 6", "Out of date 1", "Clarity 1"…), and a progress bar.
- Each suggestion has its kind, the reason, where the reason comes from ("Voice guide: “What this voice never does”", "Found without AI"), and the before and after: the whole sentence as it reads now and as it would read, the change marked in it.
- Out of date rewrites the whole sentence ("New for 2023: winter care visits" becomes "Winter care visits"), with the dated words marked in the old one, and alternatives that are meaningfully different. It's still right keeps a dated claim that is still true, quiet for 12 months or until the sentence changes.
- Accept puts the change into the form. Edit opens it in a box: Enter puts it in, Esc puts it back. Another version shows the next stored version, free; after those, Write another (uses Ghostwriter). Dismiss says it won't be suggested again. Undo takes back any of them.
- Accept all wording fixes accepts every open Voice, Clarity and SEO suggestion in the current filter, never facts, alt text, dates or duplicates. Undo all takes them back.
- Fact to check never guesses. It asks for the answer ("I won't guess. What is it now?") and Use it puts it in ("from £75 a visit"). A number must be a number. It's still right keeps the page as it is, and the check stays quiet for 12 months or until that sentence changes. Remove the number appears where the sentence works without it.
- Alt text goes into the field
->ghostwriterAlt()names, beside the image, or into an inline image's own alt text in a RichEditor. A confirm first says which file it is for and how many pages use that image. Filament keeps alt text in each record, so each page keeps its own. - Links: Filament has no entries to link to, so a link to another site found broken points at its field. In a RichEditor, paste the new address.
The guide follows Filament's dark mode.

Moving between steps, filters and versions happens in the browser. Each decision is recorded for everyone who can edit the record (as shared conversations say), with who and when. On save, accepted changes are marked done. Suggestions nobody acted on expire after 14 days; decisions are kept as the page's history.
Content to revisit
Ghostwriter → Content to revisit, the tab after Content plan, ranks the published records of every resource Ghostwriter writes for (those its published rule allows, or every record without one) by:
- age;
- past years and "this year" written as current;
- closing dates that have passed;
- counts to check;
- missing alt text and SEO values over their limit;
- no SEO description, no link to your other pages on a page of 300 words or more, and heading levels that don't fit the page (these search reasons add at most 25 together, so no page is High on search alone);
- empty fields and unfinished markers;
- links to other sites, when that check is on.
Each row shows its reasons as chips, a priority bar with its word (High, Medium, Low) and Review, which opens the record with Suggest edits: the stored review if it still fits the page, otherwise the confirm for a new one. The row's menu has Snooze for 90 days and Open without reviewing. The tiles at the top filter the list: pages worth a look, past years written as current, broken links, images without alt text.

On a panel with tenancy, each tenant has its own list.
Keeping it current
- On save: a model observer on each resource's model queues
RefreshRevisitEntryfor the record. This updates its row, its place in the index that duplicates and the review's site digest are found in, and its latest review's done and stale suggestions. Deleting a record takes it off the list. - Daily:
ghostwriter:revisitruns on the scheduler at 03:00. Records saved since the last run are scanned again, and so are rows whose date has come (a closing date passing, a new year); every other row is re-scored for its age. Once a week, and the first time, every record is scanned and the index rebuilt. It also expires suggestions nobody acted on. Opening the list before it has ever run queues a first scan. - Weekly, only when switched on:
ghostwriter:check-linksasks each site your records link to whether the page is still there. It sends a HEAD request (a one-byte GET where HEAD is refused), checks each address at most once a week and at most one a second per site, and checks no more than 500 addresses a run. A link counts as broken only after two failed checks in a row.
Both commands need Laravel's scheduler running (php artisan schedule:work, or schedule:run from cron), and a queue worker for the save hook.
Settings
Three, under Settings → Suggest edits and Content to revisit:
| Setting | Default |
|---|---|
| Flag counts and claims to check: counts and prices about you, and claims the review flags. Closing dates are always checked | On |
| Check links to other sites once a week | Off: no request is made |
| Weigh age in full for: resources with a date field weigh age and past years at a quarter, as older news is expected; tick one to weigh it like any other | None ticked |
Languages
The free checks read dates and phrases in English, German, French, Dutch and Spanish, in the app's locale, or set ghostwriter.suggest.language (GHOSTWRITER_CONTENT_LANGUAGE). Other languages get the checks that need no words: alt text, SEO length, empty fields, links and age. The review itself works in any language: its reasons are written in the language of the person who asked, and its changes follow the page.
SEO fields
Fields called seo_title, meta_title, seo_description or meta_description are found by their name; their limit is their maxLength, or 60 and 160. Name any other text field with a macro, optionally with the field shown when it's empty:
Textarea::make('meta')->ghostwriterSeo('description', fallback: 'excerpt'),
TextInput::make('share_title')->ghostwriterSeo('title'),
TextInput::make('meta_title')->ghostwriterSeo(false), // not an SEO title after all
Toggle::make('hidden_from_search')->ghostwriterSeo('noindex'), // on: the record asks not to be indexed
A description that's empty but shown from its fallback field counts as that field's text: Suggest edits doesn't call it missing while the fallback has text that fits. A toggle called noindex, no_index, seo_noindex, hide_from_search or hide_from_search_engines is found by its name too.
A new draft fills these fields too (see Search title, description and address), and Finish this page suggests a description for a page that has none.
Run php artisan ghostwriter:scan after changing a form.
Links to your pages
Filament can't tell a public model from an internal one, so drafts link only to records whose resource says how to reach them on your public site. Add ->publicUrlUsing() to the plugin, for the resources Ghostwriter writes for and for any other resource worth linking to (a Services or Contact resource Ghostwriter never writes for is a link target only: no writing panel, Finish this page or Content to revisit):
GhostwriterPlugin::make()
->resources([PostResource::class])
->publicUrlUsing(PostResource::class, fn (Post $post) => $post->is_published ? route('posts.show', $post) : null)
->publicUrlUsing(ServiceResource::class, fn (Service $service) => route('services.show', $service), key: true);
nullleaves a record out: a draft, a private record.key: truemarks the resource's records as key pages (Contact, Services, About): offered first when they're as relevant as another page.liveFrom: 'published_at'andliveUntil: 'expires_at'name date attributes: a scheduled record becomes linkable on its day without a save, and an expired one stops being linkable.
The index is kept in tables from the ghostwriter-link-index-migrations tag (see Upgrading from 1.1). Ghostwriter keeps each record's title (the resource's title attribute), public URL, a short summary (the SEO description, else its first text), and whether it asks not to be indexed. Rows are written when a record is saved or deleted, and the daily ghostwriter:revisit catches anything missed (all of them once a week, so a route changed in code reaches them). Records of the home page (/), utility pages (search, login, cart, thank-you…) and noindex records are never offered. At most 5,000 records a resource are kept (the key pages, then the most recently updated) and 20,000 a tenant; the settings page says when a resource is over. It also lists the resources Ghostwriter writes for that have no public URL.
How a draft gets its links
A new piece's first draft is linked to these records as soon as the writer finishes it: about one link per 250 words, 2 to 5, and none under 150 words (one seo-editor and one seo-verifier call; the words never change, and a link is the record's public URL). Meanwhile the draft pane says "Draft ready. Checking headings and links…", and Use this draft, Edit YAML and click-to-edit wait, so nothing changes under the editor. The conversation says what was linked under the first draft ("I linked to 2 of your pages: …").
In the draft, each link Ghostwriter added has a dotted underline and a small mark. Hovering, focusing or clicking it shows the page it goes to and why, Open page and Remove link, which keeps the words (and stops the writer putting it back). Once the draft is in the form, Finish this page asks the editor to check each one (Keep it, or Remove the link): a suggestion, never counted, never blocking.
The writer's own links are checked too, after every turn and with no call. A link to one of your public pages (a record with a ->publicUrlUsing() address, other than the page itself, the home page, utility pages and noindex records) is kept. Any other address the writer makes up (not one it was given, in the brief or the conversation) becomes a link to choose. For each link to choose in the first draft, the link calls also suggest the page it most likely means, and Finish this page offers it first ("Link to Contact us"); it's never put in for you. Links to choose don't count towards the 2 to 5.
Later turns make no link calls. Without any ->publicUrlUsing(), drafts get no links and no notice. The links are kept on the session (its seo column, from the ghostwriter-seo-migrations tag). Without that column, links are still added but not marked.
Upgrading from 1.1
Publish the three new migrations, each from its own tag, then run php artisan migrate (the plugin publishes its migrations into your app; it doesn't load them), then fill the list once:
php artisan vendor:publish --tag=ghostwriter-suggest-migrations
php artisan vendor:publish --tag=ghostwriter-link-index-migrations
php artisan vendor:publish --tag=ghostwriter-seo-migrations
php artisan migrate
php artisan ghostwriter:revisit --full
Opening Content to revisit before it has ever run queues a first scan too. The rest of the upgrade (assets, header actions, public addresses) is in Upgrading from 1.1.
What Filament can't do
- No links to other records without
->publicUrlUsing(). Filament has no entries for core to check links against, so broken internal links aren't found, and only resources with a public URL are link targets. A link to another site found broken (with the weekly check on) points at its field. - No asset library. Alt text is a form value, in
->ghostwriterAlt()fields and inline images; plain uploads without one have nowhere to keep it. - Duplicates are found across all the resources Ghostwriter writes for, in the same tenant.