Workflows migration guide

We will be discontinuing the legacy Workflows version. To maintain the workflows from the legacy version, follow the migration guide below.

Who should migrate?

This guide is relevant for you if you have the Workflows legacy version configured to your space prior to March 1st, 2023.

The legacy version will stop being supported by Contentful on June 1st, 2023. If you would like to use the new Workflows app, you will need to migrate with support offered by Contentful in the process. Please refer to the guide below to discontinue using the legacy Workflows version.

Migration steps overview:

Upgrading to the Workflows app is accomplished by going through the following steps:

1. Ensure no tag-based permissions are associated with legacy Workflows tags.

2. Create a workflow configuration in the new Workflows app.

3. Begin migration of entries assigned to the legacy Workflow steps. There are two options for this: a. Manually remove all workflow tags from affected entries and reassign identical steps created in the new app. b. Use this script to help migrate the entry statuses.

   Note: If the legacy Workflows configuration is removed prior to this process, this option will no longer be available.

4. Verify the information from the legacy version is replicated in the new app.

   Update any external systems that are relying on the legacy Workflows to the new app.