This documentation is out of date. Please check out our new documentation: Content Authoring about this topic.
Content production in enterprises sometimes requires strict workflows to make sure that every team member gets involved. Storyblok allows you to define workflow stages and rules to control what each user is allowed to do.
By default a new project in Storyblok has already three workflow stages predefined.
The predefined workflow stages are the following:
At this workflow stage users are working on the draft version of the content item and are not allowed to publish.
At this workflow stage users can review the content item and make changes.
- Ready to Publish
At this final workflow stage the users can publish the content item.
Customizing workflow stages
Workflow stages can be customized and created in the space settings area by users that are on the “Premium” plan level. Please check your plan level in the subscription area of the Storyblok app.
To force users to fulfill a specific workflow we recommend following setting:
- Check the checkbox “Define as default stage for new content items”
- Set “Reviewing” as “Next available stages”
- Set “All users” as “User(s)/Role(s) who can change the stage Drafting to the next available stage”
- Set “Ready to publish” as “Next available stages”
- Set a list of reviewer emails or a reviewer role as “User(s)/Role(s) who can change the stage Reviewing to the next available stage”
- Ready to Publish
- Check the checkbox “Allow users to publish or schedule the content”
- Set “All stages” as “Next available stages”
- Set a list of publisher emails or a publisher role as “User(s)/Role(s) who can change the stage Reviewing to the next available stage”
With this setup users will need to go through all workflow stages when creating new content items.
How to create a new workflow stage
To add a new workflow stage define a color and a name. Then click “Create” to add the stage to the bottom of the list. To change the position of the workflow stage click on the “Settings/Cog” icon, change the value of the “Position” field and click “Save”.
How to configure a workflow stage
Click on the “Settings/Cog” icon to define the settings of a workflow stage:
Define a name describing the task of this workflow stage.
Define a color to help users identify the workflow stage visually.
Define the position of this workflow stage.
If checked this workflow stage will be set as default when creating a new content item. If unchecked the content item will not have any workflow stage defined.
- Publishing rights
If checked the users are allowed to publish the content item or if the users are editing a content item within a release they can schedule the content item. If unchecked the users are only allowed to save the content item.
- Stage transition rules
With this settings you can define which workflow stages are available for which users at the selected workflow stage.
For example: You can define a space role “Editors” and another “Approvers/Publishers” and only allow only “Approvers” to set the workflow stage to “Ready to Publish”. To make sure that in this case the “Editors” can not publish a content item define the “Drafting” stage as “Default” stage.
How to filter items by workflow stage(s)
In the content browser you can filter by workflow stages and content items assigned to you clicking link “Filter”. This filtered view can also be bookmarked with your browser’s bookmark functionality.
How to change the workflow stage
To change a workflow stage go to a content item, open the “Status” tab in the sidebar and click the link “Change”. This will open a dialog where you can see the available workflow stages. Choose specific users or roles and check “Notify users via email” to notify the users of the workflow stage change of this content item.