Payload CMS admin vs on-page editing: when to use which

Payload gives developers a typed, code-first CMS and editors a clean admin. For creating a page or modelling a new collection, the admin is the right place. For changing one sentence on a page that's already live, it's a long way round.

What Payload's admin does best

Payload's admin is generated from your config: every collection, field, validation rule and access function you define in code shows up as a clean, typed form. That makes it the right place for:

Where the admin is a long way round

Now take a typical request: “the second paragraph on the services page sounds stiff — can we make it friendlier?” In the admin, an editor has to work out which collection the page comes from, find the document, find the field (perhaps inside a block, inside an array), make the change without seeing it in context, save, and go back to the site to check. If they get the wrong document, nothing visibly happens.

Payload's live preview narrows that gap by showing the page next to the form. But the editing still starts in the admin, with the form as the main surface.

What on-page editing adds

The payload-vibe-editor plugin flips it: the editor starts on the page. They turn on edit mode with a switch, click the paragraph, ask for a friendlier version or type it, see it in place, and save. Behind the scenes:

Your access control still decides

This is the part that matters to developers. On-page editing in Payload is not a side door:

What editors can change on the page

A sensible split

TaskUse
Create a new page, article or productPayload admin
Change blocks, relationships or page structurePayload admin
Long, heavily formatted rich textPayload admin
Fix or rewrite a heading or paragraphOn the page
Swap a picture or write its alt textOn the page
Improve a page title or meta descriptionOn the page

Both paths write to the same documents with the same permissions, so there's nothing to keep in sync. Developers keep Payload exactly as they designed it; editors get a faster way to do the small things. If your front end is Next.js without Payload, the Next.js adapter gives you the same editing on your own database.

Keep reading

Add inline content editing to a Next.js site

Give editors click-to-edit on an App Router site while you keep your auth, your database and a strict field allow-list.

4 min read

Page builders vs headless CMS vs on-page editing: what your editors need

Three ways to let people change a website, what each is good at, and why on-page editing works next to the other two.

3 min read