Skip to main content

Move a workflow template to the new Workflows app

Copy a Workflows 1.0 template into the new Workflows app, and see what carries over and what works differently.

Written by Efrat Barak Zadok

You can copy a template from Workflows 1.0 into the new Workflows app, which now includes automatic enrollment. The Workflows assistant builds the new workflow for you and tells you what needs your attention. Your original 1.0 template is never changed or deleted, so you can keep using it while you set up the new one.


Who can use it

Anyone who can manage workflows can migrate a template.


How to migrate a template

  1. In Workflows 1.0, open the template you want to move.

  2. Click ⋮, then Migrate to new workflows. You can also click Migrate to new workflows on the banner at the top of the template page.
    ​
    ​

  3. The new workflow builder opens, and the Workflows assistant sends this message for you: Migrate my v1 workflow template "[template name]" (#[template ID]) to a new workflow.

  4. The assistant reads your template and builds the full workflow.

  5. Read the assistant's reply. It ends with a Not migrated, needs your input list showing everything that works differently in the new workflow.

  6. Click Apply to save the workflow as a draft.

  7. Fix each item on the list, then click Publish.

What happens next

Your new workflow stays as a draft until you publish it, and a draft doesn't run. Once it's published, it starts manually: open it and click Run Workflow to start it.


What carries over

Each step from your template is copied, in the same order, with its name, message, timing, recipients, conditions and files. Webhook URLs and secrets are copied too.


What works differently

The trigger becomes Manual. Start the workflow with Run Workflow.

Approvals become tasks. An approval step becomes a Complete task step named "Approve". If someone rejects it, the steps after it still run.

Some steps run straight away. A step set to a fixed calendar date, or with no timing set, runs as soon as the workflow starts.

Missing recipients go to the manager. If a recipient no longer exists, the step goes to the employee's manager instead.

Some conditions are removed. Conditions that use "greater than", "less than" or "contains" aren't copied. The step then runs for everyone.

Some files may need re-uploading. If a file can't be copied, a notice names it. Upload it again on that step.


Related articles

Did this answer your question?