Prompt
How do I set up editorial approvals and scheduling in a headless CMS?
Latest observation
To set up editorial approvals and scheduling in a headless CMS, you usually combine content workflow states, roles/permissions, and publish scheduling features. The exact clicks vary by CMS, but the design is generally the same.
1) Define your workflow stages
A simple editorial workflow might look like:
- Draft — author creates or edits content
- In Review — content is ready for editor review
- Approved — content passes review
- Scheduled — content is approved but not yet published
- Published — content is live
- Archived — content is no longer active
If you need more control, add states like:
- Needs changes
- Legal review
- Fact-check
- Final sign-off
2) Set up roles and permissions
Create clear access levels so people can only do what they should.
Typical roles:
- Author: create/edit drafts, submit for review
- Editor: review, request changes, approve content
- Publisher/Manager: schedule and publish
- Admin: manage workflow, roles, settings
Permission examples:
- Authors can edit only their own drafts
- Editors can edit any submitted content
- Only approved content can be scheduled
- Only specific users can publish immediately
3) Use content statuses or workflow states
Most headless CMSs let you assign a status field or use a built-in workflow engine.
Recommended setup:
- Draft content is not public
- “Submit for review” changes status to In Review
- Editor changes status to Approved
- Approved content can then be Scheduled or Published
If your CMS doesn’t have workflow built in, you can create a custom field like:
status: draft | review | approved | scheduled | published
4) Enable scheduling
Scheduling means setting a future publish time.
Common fields:
publish_at— date/time to go liveunpublish_at— optional date/time to take content downtimezone— important if your team works across regions
Good practice:
- Only allow scheduling after approval
- Validate that
publish_atis in the future - Store timestamps in UTC and display them in the user’s local timezone
5) Add approval gates
Make sure content can’t skip review.
Examples of approval rules:
- Authors cannot publish directly
- Content must be marked approved before scheduling
- Scheduled items can only be edited by editors/admins
- Changes after approval may reset status back to draft or review
This prevents accidental publishing of unfinished content.
6) Set up notifications and reminders
Help editors and authors know what needs attention.
Useful automations:
- Notify editors when content is submitted
- Notify authors when content is approved or rejected
- Remind reviewers about pending items
- Alert the team when scheduled content is about to publish
7) Handle versioning and audit logs
Editorial workflows work much better with history.
Look for:
- Version history
- Change tracking
- Comments or review notes
- Audit logs showing who changed status and when
This helps with accountability and rollback if something goes wrong.
8) Test the full workflow
Before going live, test these scenarios:
- Author submits draft for review
- Editor approves and schedules content
- Scheduled content publishes at the right time
- Rejection sends content back for revision
- Last-minute edits don’t accidentally publish early
Test with different time zones too.
9) If you’re using a specific CMS
Many headless CMSs have built-in support for this, for example:
- Contentful: environments, roles, scheduled publishing via app/automation
- Strapi: custom workflows/plugins, roles/permissions, publish scheduling
- Sanity: custom workflow tools, scheduled publishing with plugins/scripts
- Prismic: release/scheduling features
- Directus: granular permissions, status fields, automation
- Storyblok: workflow states and scheduling
10) Recommended implementation pattern
A practical minimal setup is:
- Content type has fields:
titlebodystatuspublish_atreviewer
- Workflow:
- Draft → In Review → Approved → Scheduled → Published
- Permissions:
- Author: edit draft, submit for review
- Editor: approve/reject
- Publisher/Admin: schedule/publish
- Automation:
- Scheduled job publishes content when
publish_at <= now
- Scheduled job publishes content when
If you want, I can also show you:
- a CMS-agnostic workflow diagram,
- a Strapi/Contentful/Sanity-specific setup, or
- a database schema + API example for implementing this yourself.