Strapi review workflows for editorial approval

Strapi review workflows add staged editorial approval so content must pass a defined review step before it can be published. They are an Enterprise feature in Strapi's self-hosted plans, so the plan decision comes before the design.

On this page

How Strapi review workflows enforce editorial approval before publishing

An editorial lead who needs legal or brand sign-off before anything goes live should treat Strapi review workflows as the control that puts that sign-off into the content path itself. Review workflows add stages and permissions to the route a draft takes before publishing, so approval is built into how content moves rather than left to individual habit. The feature is an Enterprise capability in Strapi's self-hosted plans. The supplied pricing information lists review workflows as an Enterprise feature, alongside audit logs, while content history and releases start at the Growth plan. A team that needs enforced approval should confirm this requirement before it chooses a plan.

Teams that usually need this feature are those where publishing carries legal, regulatory or brand risk. Typical examples include marketing sites that make product claims, healthcare or financial content that needs compliance review, and public sector publishers that must record who approved a change. Illustrative example: a writer drafts a product page, a brand reviewer checks tone and terminology, a legal reviewer checks regulated statements, and only a small group holds the right to publish. Each of those roles maps to a stage and a permission set. Before you build, list every group that touches content and write down which of them should be able to approve, return or publish.

The main design decisions sit with your editorial process, not with the software. Decide which roles can move a document into each stage and out of it, whether reviewers can edit content or only approve or send it back, and whether any content type should skip a stage. Then test the path with real content types in a non-production instance. Confirm in your Strapi version that the required approval stage blocks publishing for every content type in scope, and check how the workflow behaves with localized fields and scheduled releases. Those interactions can change how reviewers work, so record the results before you rely on them.

Cost has two parts. The Enterprise license is priced on request, so ask Strapi for a written quote that names the plan, the number of users and any support terms. The Growth plan is listed at 45 US dollars per month including 3 users, plus 15 dollars per extra user, but it does not include review workflows, so it is not a substitute for this control. Implementation effort is a separate cost paid to a partner or your own team. It covers role design, stage configuration, testing and training for reviewers. Ask for these items as separate line items in the scope so that you can see which parts recur and which are one-time work.

Strapi review workflow options and when each fits

This table compares the design choices a team makes when setting up editorial approval in Strapi, from stage count and role permissions to publish blocking and scope by content type and locale. Read each row as a decision to settle before configuring anything. The main takeaway is that enforced review workflows are an Enterprise feature, while Growth and Community teams rely on content history and a manual approval convention.

Design choiceWhat to decideWhen each option fits
Number and naming of stagesHow many review steps exist and what each stage is calledFew stages suit small teams with one reviewer. More stages fit separate editorial, legal or compliance sign-offs.
Roles that move content in and outWhich roles may send content into a stage and which may approve or return itSeparate roles fit when authors, reviewers and publishers must not be the same people. Confirm the exact role options in your version.
Required stage before publishingWhether publishing is blocked until content has passed a specific stageA required stage fits regulated content that needs a recorded approval before it goes live. Confirm how enforcement behaves in your version.
Scope by content type and localeWhether the workflow applies to all content types or selected ones, and whether locales can follow different pathsNarrow scope fits teams that review only high-risk content. Wide scope fits teams with one approval path for everything. Confirm locale behavior.
Plan requirementWhich Strapi self-hosted plan includes each controlReview workflows and audit logs are Enterprise features. Content history and releases start at Growth. Community has neither.
Fallback on Community or GrowthHow approval is evidenced when Review Workflows is not availableUse content history and releases on Growth for traceability. A manual approval convention is not enforced by Strapi, so restrict publish rights to approvers.

Why Strapi review workflows need the Enterprise plan

Review workflows are the feature that decides the plan. Strapi's self-hosted pricing page lists review workflows as an Enterprise feature, so a Growth or Community deployment cannot enforce named approval stages inside the CMS. Before you design stages, decide whether the CMS itself must block publishing until an approver has signed off. If it must, Enterprise is the only listed route. If approval can live in editorial convention and a ticket trail, a lower plan may be enough, but then you carry the enforcement risk yourself.

The Enterprise decision is rarely about one feature. The same pricing page places audit logs in Enterprise, lists SSO as an add-on for Growth and as included in Enterprise, and starts content history and releases at Growth. Work out which of these your editorial and compliance requirements actually depend on. If you need approval gates and audit logs together, the cost comparison is against a package, not a single feature. Also note that Strapi SSO covers administrator login to the admin panel only, so reviewer identity and role mapping still need a separate design on any plan.

Enterprise pricing is custom, so no figure in this section should be treated as a budget. Ask Strapi for a written quote that states the license term, the renewal conditions and any annual uplift, the number of admin seats, the support level, and whether SSO and audit logs are included. Compare that against the Growth price, which Strapi lists at 45 US dollars per month including 3 users and 15 US dollars per additional user. Editors, reviewers and publishers all count as seats on Growth, so an approval chain with many reviewers can change the Growth total. Implementation effort is a separate line that is quoted from the scope, not from the license.

On a lower plan, the team loses the native stages and the enforcement that come with them, and must build substitutes by hand. Illustrative example: a status field on each content type, role checks in custom middleware or policies, a webhook that notifies reviewers, and a log of approvals kept outside Strapi. Each piece is code you must write, test, document and update through Strapi 5 upgrades. The main risk is a bypass: custom checks often guard the admin panel but not every API path, so confirm that any publish action is blocked in the Document Service API as well as in the admin UI before you rely on it.

Before committing, ask Strapi to confirm in writing that the review workflow features in your target version cover the stages, roles and publish gate you have designed, and that the Enterprise license terms, which sit under a separate license for code in the ee directories, are acceptable to your legal team. Ask whether an evaluation environment is available so the team can test the gate with real roles before purchase. Keep the approval design document as the reference for the quote, so the scope you priced and the scope you build match.

Setting up Strapi review workflows for editorial approval

This sequence turns an editorial approval process into Strapi configuration that is confirmed in a staging instance before editors rely on it. It covers licensing, roles, stages, transition rules and the publishing gate.

  1. Confirm the Enterprise license and Strapi version

    Before any configuration, confirm that the instance is on the Enterprise plan, since review workflows are an Enterprise feature in Strapi's self-hosted plans. Check the Strapi version in use against the Strapi documentation for review workflows, because admin paths, labels and permission options can change between minor releases, and Strapi 5 minor releases ship frequently. Record the exact version and plan in the project notes. The step is done when a platform owner can show the license status in the admin panel and the version is written into the change record, so every later check is tied to a known release.

  2. Map editorial roles and content types

    Work with the editorial lead to list every role that touches content, such as writer, editor, legal reviewer and publisher, and state what each role must be able to do. Then list the content types and components that need review, and separate them from types that can publish without approval. Document which roles hold admin panel access and which only use the API. Output is a role-to-action matrix signed off by the content owner. The step is complete when every content type that needs review is named and every role has one agreed set of permitted actions, with no role left without a defined purpose.

  3. Define stages and transition rules

    Create the review stages in the order content moves through them, for example draft, editorial review and legal approval, using the labels your team will recognize. For each stage, set which roles can move content into it, out of it and to which next stage. Keep the rules explicit: a writer may move a draft into review, but only a reviewer may move it onward. Record the rules in a table next to the role matrix. The step is done when every stage has a named entry role and exit role, and every transition in the table maps to a role that exists in step two.

  4. Apply stage permissions to roles

    Assign the stage-level permissions in the admin panel so each role can only see and move content where the transition table allows. Confirm the exact permission names and locations for your version in the Strapi review workflow documentation before editing roles. Apply changes to a copy of the role set first, then to the working roles once tested. The check is that the role editor shows the same permissions as the matrix, with no extra publish or stage-move rights granted through unrelated content permissions. Record any permission the documentation does not clearly cover so it can be verified with Strapi.

  5. Enable the required stage before publishing

    Turn on the setting that requires content to pass a designated stage before it can be published on the content types that need review. Confirm the option's label and location for your version, since the setting is the control that stops direct publication. Then run the publish check with the writer account: attempt to publish a draft that has not passed the required stage and confirm the action is blocked. Repeat with a reviewer account to confirm the reviewer can move content only through permitted transitions. The step is complete when the writer cannot publish directly and every blocked attempt is recorded in the test log.

  6. Test a draft through every stage in staging

    Create a test entry on a staging instance that mirrors the production schema and roles. Move it through each stage using the accounts assigned to each role, checking at every move that the correct role can transition it and that other roles cannot skip or reverse steps they should not. Include negative tests such as a writer attempting to publish, a reviewer attempting an unpermitted move and a user with no review role opening the entry. Note the result of each check against the matrix from step two. The step is done when every stage transition and every negative test has a recorded pass or a documented defect with an owner.

  7. Confirm the sign-off and handover

    Before production use, have the content owner review the test log, the role matrix and the transition table, and confirm that the configuration matches the approved process. Repeat the key publish-blocking check on production with a test account and remove it afterward, or confirm it on a production-like environment if you prefer not to touch live content. Document the Strapi version, plan, roles, stages and the date of sign-off, and assign an owner for future changes after Strapi upgrades. The step is complete when the signed record exists and the owner is named, so that any later change to roles or stages is reviewed against the approved baseline.

Designing stages and role permissions for each editorial step

Design the editorial path on paper before you configure anything in the Strapi admin panel. Start by listing each stage an entry passes through, such as draft, editing, approval and published, and then name one accountable owner for each stage. For every stage, write down which roles can move an entry into it, which roles can move it out, and where it can go next. A short matrix with stages as rows and roles as columns is usually enough to show gaps before any permission is set. Treat this matrix as the design document that the configuration must match.

Two failure points appear more often than others. The first is a stage with no owner. If nobody holds the right to move entries out of a stage, content stops there and editors start working around the workflow. The second is a publisher who can bypass approval through another permission. A role may be denied the approval transition but still hold a permission that changes publication state directly, or an API token may have publish rights that no one reviewed. Check every permission that can change publication status, including those granted through custom roles, admin roles that can edit content types, and API tokens, not only the workflow settings themselves.

Content types do not always need the same approval path. A press release may need legal review, while a product FAQ may need only editorial sign-off. Decide whether each content type gets its own workflow or whether several content types share one, because the number of workflows and stages will shape how much administration your team takes on over time. If you use localization, also confirm with your Strapi version and plan whether approvals apply per locale or to the entry as a whole, and record that answer in the design matrix before you build.

Validate every permission in staging before production use. Create one test account for each role in the matrix, plus one account that holds the combined permissions of a single person who may act in several roles. Using each account, attempt every allowed transition, every blocked transition and a direct publish, in both the admin panel and the API where the content is served. Record the expected and actual result for each attempt. Review workflows are an Enterprise feature in Strapi's self-hosted plans, so confirm your plan before you start this design, and keep the test record as evidence for your change review.

Security and audit considerations for approval stages

When an approval step is a compliance or brand control, the approval itself must be attributable, restricted and unchanged without a record. The cards below cover who can sign in as an approver, what each role may move, what evidence the platform keeps and how changes to the workflow itself are governed.

Admin access and SSO for approvers

Strapi SSO governs administrator login to the admin panel through an identity provider, with auto-registration, a default role and an optional local login lock-out. It does not authenticate end users of your front end, which the Users and Permissions plugin handles separately. Confirm which accounts approvers use, whether they sign in through the identity provider, and whether local passwords remain available for emergency access.

Least-privilege stage roles

Each review stage should be movable only by the roles that own that step, so an editor cannot push their own content into a stage reserved for legal or brand reviewers. Map every stage to the people who may enter it and the people who may send content out of it. Test the mapping with a non-admin account before go-live, since admin accounts typically bypass the restrictions an approver depends on.

Audit logs as approval evidence

Audit logs are an Enterprise feature in Strapi's self-hosted plans and record administrator actions. For an approval trail, the question is whether the log shows who moved an entry into a stage, who approved it and when it was published. Ask for a sample export during evaluation, check the default retention period against your record-keeping rules, and decide whether logs will be shipped to a SIEM for longer retention.

Change control for stages and roles

Stage definitions and role permissions are configuration, and a silent change to either can remove an approval step without anyone noticing. Keep the workflow definition in a reviewed change process, record who may edit it, and compare the live configuration against the approved version after each upgrade or deployment. Treat any change that adds a bypass path as a security change, not an editorial one.

Separation of duties in approvals

Where regulation or brand policy requires that the author and the approver differ, the workflow must prevent one person from holding both roles on the same entry. Confirm in the Enterprise plan how stage permissions interact with authorship, and test a case where one account drafts and attempts to approve. Document any residual gap and the compensating control, such as a second review by a different team.

Evidence and independent assessment

DeployOpen plans and configures the controls, sets up logging and collects the evidence that shows they operate. An independent auditor or certification body decides whether the controls meet a given requirement. Agree with your assessor, before implementation starts, which evidence they will request, such as role exports, configuration history and audit log extracts, so the build produces it.

Testing approval paths before editors depend on them

Test every approval path in a non-production copy of the instance before any editor is told the workflow is live. The test plan should cover each role against each stage, and each transition between stages. For every role, record what it can see, what it can move, and what it is blocked from doing. A test plan that only confirms the happy path, where an editor submits, a reviewer approves and the content publishes, will miss the failures that matter most to an approval process.

Three negative tests deserve their own cases. First, attempt to publish from a role that has no approval authority, using both the admin panel and direct REST or GraphQL requests. Second, attempt to reach the published state while skipping the required stage, for example by changing status through an API call or a script that uses an account with broad permissions. Third, move content backward after it has been approved, and confirm whether that movement resets the approval or leaves a published version unreviewed. Confirm with your Strapi configuration whether the admin panel restrictions also apply to API requests, because a control that holds in the interface but not in the API is not an approval control.

Run the tests against a copy of production content on the same Strapi version and the same plugin set as the production instance. Keep the database engine, Node.js version, locales and content types identical as well. Workflow permissions and stage assignments are tied to the content types and configuration of the instance, so a test on a fresh install with sample data can pass while production fails. Ask your team to confirm the restore procedure for the copy and to decide how personal data in that copy will be handled before testers access it.

Record each test with an identifier, the role used, the starting stage, the action attempted, the expected result, the actual result, the tester and the date. Also record the Strapi version, the plugin versions and an export of the workflow configuration at the time of testing. Keep these results with the release record, because they show what was verified and under which configuration. Your auditors or certification body will decide whether this evidence meets their requirements. DeployOpen can prepare the test results and the configuration records, but it does not issue audit reports or attestations.

Repeat the approval path tests after any change to roles, stages, permissions, plugins or the Strapi version, and before each upgrade is promoted. Assign one owner for the test plan and one person to sign off the results before editors receive access. A written sign-off step turns the test record into a decision that can be reviewed later, and it gives editors a clear date from which the workflow can be relied on.

Limits to confirm for your Strapi review workflow

Several behaviors that decide whether a review workflow fits your editorial process need confirmation before you design around them. Test each item below in a non-production instance running the exact Strapi 5 version you plan to operate.

Number of allowed stages

Stage count sets how many sign-offs a draft passes before publishing, and each added stage adds role assignments and a point where content can wait. Confirm the maximum number of stages per workflow in Strapi's documentation for your version. Then build your longest planned approval chain, including a step that sends content back to an earlier stage, and confirm that the chain saves and runs as designed.

Required stage for API and scheduled publishing

Editors often assume the required-stage rule blocks every publish path, but the rule may apply only to publishing from the admin panel. Check whether a publish request sent through the content API is refused when the entry has not cleared the required stage. Then check scheduled publishing, which runs without an editor present, and confirm the same rule applies at the moment the job fires.

Releases and localized content

Releases group content for coordinated publishing, and each localized entry carries its own review state. Confirm whether a release can include entries that are still in a review stage, whether approving one locale approves the others, and whether a locale added after the workflow starts enters the stage it should. Run one release with two locales through the full approval path before you commit to the design.

Document Service API behavior

Strapi 5 replaces the Entity Service API with the Document Service API, so custom controllers, services and lifecycle code written for earlier versions need review. Confirm that stage transitions, role checks and the required-stage rule behave the same when triggered through the Document Service API in your custom code as they do in the admin panel. Write a test for each transition that your code can trigger.

In-flight reviews during minor upgrades

A review that starts under one minor release may still be open when the next one is installed. Confirm how the workflow stage, assigned roles and pending transitions are stored and read after an upgrade, and whether any stage is reset or re-evaluated. Rehearse the upgrade on a copy of production data that holds open reviews, and record which items keep their stage.

Version-specific behavior and plan tier

Strapi 5 minor releases have shipped roughly weekly, so behavior confirmed on one version may change on the next. Record the exact version in every test report, retest the workflow after each planned upgrade, and confirm with Strapi that review workflows are included in the plan you intend to buy before you design around them.

Questions buyers ask about Strapi review workflows

How much does the Strapi Enterprise plan cost for review workflows?

Strapi lists Enterprise pricing as custom, so the license fee comes from a quote from Strapi, not from a published price. Review workflows are an Enterprise feature on Strapi's self-hosted pricing page, so the license is the first line item to confirm. Ask the vendor for the recurring fee, its billing period, the number of users it covers, and what support terms are included. Enterprise code sits under a separate Strapi license, while the Community Edition is under the MIT Expat license, so your legal team should review that license before rollout. For comparison, Growth is listed at 45 US dollars per month with 3 users included and 15 dollars per extra user, but Growth does not include review workflows.

What drives the cost of a Strapi review workflow build?

The build is a DeployOpen engagement, and most engagements are fixed-scope, so the price follows from a written scope. DeployOpen does not publish a price list. The main drivers are the number of content types and locales that need an approval path, the number of stages and who approves each one, the number of roles whose permissions change, whether you need SSO for administrators, and how many environments need testing and handover. One-time work covers design, configuration, testing and documentation. Recurring costs include Strapi licensing, hosting and any retainer for upgrades. Ask for a quote that lists each stage, the role matrix, the environments and what is excluded.

How long does designing and configuring Strapi review workflows take?

Duration depends on the agreed scope, and DeployOpen sets timelines in the written scope rather than quoting a standard figure. In general terms, design takes the most time because the team must agree on the stages, who can move content into and out of each stage, and which stage is required before publishing. Configuration is shorter once the permission matrix is signed off. Testing with the editorial scenarios your team actually runs adds further time. The main schedule risks are stakeholder availability, disagreement about approval policy and any identity or environment work that must come first. Ask for milestones and a list of the decisions the client must sign off at each one.

What must our team provide before Strapi review workflow work starts?

Three inputs decide how fast the work can move. First, a list of roles with named owners, such as author, editor, reviewer and publisher, and the permissions each role needs. Second, a written approval policy that states each stage, the required stage before publishing, who may skip a stage, and how exceptions are escalated. Third, test accounts for each role in a non-production environment, so the workflow can be verified before it reaches production. Your team should also provide admin access for the configuration, identity provider details if administrators will sign in with SSO, and an inventory of the content types in scope. Confirm which of these owners will be available for review sessions.

Can an internal team set up Strapi review workflows without a partner?

An internal team can set up review workflows alone if it has hands-on Strapi administration experience, holds an Enterprise license, and has a non-production environment for testing. The configuration steps are not the hardest part. The difficult parts are agreeing on the approval policy, designing the role permissions so they match that policy, and proving the workflow works for every role. Your team should also plan how the setup is maintained through future Strapi upgrades. A partner is most useful when stakeholders disagree on policy, when the team lacks capacity for testing, or when the workflow must be documented for audit. Check Strapi's current documentation for the setup steps before you commit.

What changes if our organization stays on the Growth plan?

On Growth, you cannot use review workflows or audit logs, because both are Enterprise features on Strapi's self-hosted pricing page. Content history and releases are available from the Growth plan, so those remain open to you. SSO is an add-on for Growth, while Enterprise includes it. Growth is listed at 45 US dollars per month with 3 users included and 15 dollars per extra user, and you should confirm current limits with Strapi before you decide. If you stay on Growth, editorial approval must run as a documented manual process, outside Strapi, with a separate record of who approved each change. That process still needs roles, an approval policy and test steps, so the design work does not disappear.

Which Strapi edition includes the review workflow code and license?

Review workflows sit in Strapi's Enterprise Edition, and the code under the ee directories is licensed under a separate Strapi license. The Community Edition is licensed under the MIT Expat license, so an open-source build alone does not give you review workflows. Before you commit, read the Strapi license file and confirm the terms for your intended use with Strapi. Engineers should also check how the Enterprise license is enforced in the version they deploy, and test it after each upgrade. Keep Enterprise and Community code clearly separated in your repository so that reviewers can see which parts depend on the license.

How DeployOpen scopes and delivers Strapi approval workflows

DeployOpen plans and implements Strapi review workflows for editorial approval inside infrastructure you control. Each engagement starts from a written, fixed scope that defines the stages, role permissions and required pre-publish step, then moves through build, testing, documentation and handover. Ongoing support and upgrades are available as a retainer.

How we scope

  • Map your editorial stages, from draft through legal or brand review to publication, before any configuration begins.
  • Define which roles may move entries into and out of each stage, and who can publish.
  • Confirm the Enterprise plan requirement for Review Workflows and the Strapi self-hosted license terms with your team.

How we build

  • Configure workflow stages and permissions in a staging instance that mirrors your production content types.
  • Test the required review stage so content cannot reach publication without passing through it.
  • Check permission boundaries with test accounts for each editorial role, including edge cases such as rejected entries.

How we hand over

  • Deliver written documentation of stages, role matrix, permission rules and the publishing path.
  • Walk your editors and administrators through daily use of the approval flow and the admin panel.
  • Record configuration decisions so your team can extend stages or roles later without rework.

How we support

  • Offer ongoing support, Strapi version upgrades and workflow changes as a retainer agreed in writing.
  • Review permission and workflow configuration again when Strapi minor releases change admin behavior.
  • Confirm with your team which audit and history records must be retained alongside the approval process.

Sources and further reading

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.