How to set up workflows and approvals in Vaiz
Workflows in Vaiz define how tasks move between statuses on a board. You can choose where new tasks start, set allowed transitions, and assign approvers to review work before it moves forward.
For example, your team can follow this process:
Todo → In Progress → Review → Done
You can set up your workflow manually or describe your process to the Vaiz AI agent, and it will configure the workflow for you.
Step 1. Open the workflow editor
- Select your space, open the project, and choose the board.
- Click the board settings icon in the top-right corner.
- Select Workflow from the menu.
If you’re starting from scratch, create a board first.
Before defining transitions, check that the board has the statuses your team needs. For this example, use Todo, In Progress, Review, and Done. You can add or rename board groups using the board customization settings.

Step 2. Choose where new tasks can start
Set which statuses allow new tasks to be created.
For this example, allow tasks to start in Todo. Keep In Progress, Review, and Done for tasks that have already moved through the workflow.
New work will enter the board in Todo and follow the transitions you define next.

Step 3. Define allowed transitions
A transition connects a task’s current status to a status it can move to next.
Configure the main path:
- Todo → In Progress: someone starts working on the task.
- In Progress → Review: the work is ready to be checked.
- Review → Done: the work has been reviewed and approved.
Add a return path from Review to In Progress for work that needs changes.
If every task must go through review, leave out a direct transition from In Progress to Done.

Step 4. Add an approval step
Use an approval step when a specific person needs to review the work before it moves forward.
For this example, require approval before a task moves from Review to Done. Assign the team member responsible for checking the result.
A content team might assign an editor to review an article. A development team might assign a QA lead to check a completed feature.
If the reviewer hasn’t joined your space yet, invite them to your team before assigning them as an approver.
Include a path back to In Progress so the team can make changes and submit the task for review again.

Step 5. Check the workflow
Review the diagram before applying your changes. Make sure tasks have a starting point, a path to completion, and a way to return for changes.
Once the workflow is active, try it with a test task:
- Create a task in Todo.
- Move it to In Progress, then Review.
- Check that approval is required before it can move to Done.
- Check the return path from Review to In Progress.
Workflow rules apply when you drag tasks between columns, change their status inside a task, or move them through automations.
To check when a task moved between board groups and who made the change, open Project History.
Create a workflow with AI
Describe how your team works to the Vaiz AI agent, including the statuses tasks should move through and where approval is needed. The agent will configure the workflow based on your description.
For example:
Set up a workflow for this board with Todo, In Progress, Review, and Done. New tasks should start in Todo. Allow Todo → In Progress and In Progress → Review. Require approval from [reviewer’s name] before a task moves from Review to Done. Include a return path from Review to In Progress for changes.
Once the agent finishes, review the workflow and adjust any settings if needed. Check the starting statuses, allowed transitions, and assigned approvers, then try the workflow with a test task.

If a task cannot move to another status
Check that the workflow includes a transition from the task’s current status to the destination you need.
If that transition requires approval, check whether the review is complete. If a team member cannot access or edit the task, review their roles and permissions.
If an automation cannot move a task, check the same workflow rules. Automations also follow the board’s allowed transitions. For help checking triggers, conditions, and actions, see how to set up automations.