Blueprint | Online Help | Zoho Projects


Zoho Projects Blueprint helps you define and design a workflow to automate processes in an organized manner. The main components of a blueprint are statuses and transitions:

  • A status indicates what stage a task is in at a particular point in the workflow.
  • A transition is a link between two statuses and allows a task to move from one status to another.

To illustrate this, let's look at the workflow of the content review process at Zylker, Inc. Content review is a task assigned to the content team. They use Blueprint to automate the workflow of the review process. You can design a blueprint tailored to your business process.

In this blueprint, the review status is updated as it goes through various transitions. For example, the task status will be updated from Open to In progress via the Submit for review transition.

This help guide will show you how to design a blueprint with statuses and transitions, configure the transitions, and execute a blueprint.

  • Feature Availability: Premium and Enterprise plans
  • Navigate to   > Task Automation > Blueprint to create a blueprint. If you are an admin but unable to access the above path, write to

Create a Blueprint

  1. Click  in the upper right corner of the top bar.
  2. Navigate to Task Automation > Blueprint. 
  3. Click New Blueprint.
  4. In the popup, enter a blueprint name, select a layout, and enter a description for your blueprint.
  5. You can specify criteria based on which the blueprint will be executed:
    • If you want the blueprint to be executed for a particular task, specify the task name in the criteria. 
    • If you don’t specify any criteria, the blueprint will be executed for all modules.
  6. Click Save.

Design a Blueprint

Once your blueprint is created, you can customize its design in the Blueprint Editor. Drag and drop statuses from the Available Status section to the Blueprint Editor or add new task statuses.

To establish a connection between task statuses, either:

  • Connect the nodes from one status to the next status in the workflow, or  
  • Drag a node from a status in the Blueprint Editor to create a new status.

The available statuses are the task statuses which are currently in your task layout. You can also add new task statuses. Know more about task custom status.

Add New Status

  1. Click Add next to Available Status.
  2. Enter the task status name.
  3. Select the status type. The default types are Open and Closed.
  4. You can choose a color for the status.
  5. Click Save.

  • The newly added status in the blueprint will be saved to layouts only when you publish the blueprint.
  • If you are reusing the same status in more than one blueprint, the corresponding status types will also be the same.

Edit or Remove Status

  • To edit a status, click the status name in the workflow. The status details will be displayed in the right panel. Edit the necessary details and click Save.
  • To remove a status, click the status name in the workflow and click in the top right corner of the status details panel.
Once the task has been updated with status, the type of that status cannot be modified.

Configure Transitions

A transition is a link between two statuses that allows a task to move from one status to another.

To Configure:

  • Click + button in the link between two statuses.
  • Enter the transition name.
  • Enable Common transition and select the statuses for which this transition will be available.
  • Configure the Before, During, and After transition settings.

Before Transition

In Before Transition, you can define criteria and perform the transition.

For example, in the content review process, only the content team’s manager can approve the content, given the due date and the content attached. In the Before Transition settings for the Approve transition, select Manager as the user and set the criteria with due date and attachment.

To Configure Before Transition:

  1. Click on the Select user box and select the users who can perform the transition.
    • You can select Assignee, Reporter, or any of the project users or roles in the Select User box.
  2. Click Add Criteria button to set the criteria for triggering the transition
Only the selected users or roles will be able to view the transition button in the task details page and perform the transition. If no users are selected, the transition button will be available to all users.

During Transition

During Transition is configured with fields and messages. When the user performs a transition, they will give inputs to the fields. Messages are inserted as information or instructions to be displayed during the transition.

For example, in During Transition configuration for the Approve transition, Comments is added as a mandatory field and “The review process will be complete after this transition” is added as a message. This means that when the manager performs the Approve transition, they will be prompted to add a comment and will see the message displayed in the pop-up. 

To Configure During Transition:

  1. To insert a field, click  Add and select  Field. Choose the required field from the selection box and click Add.
    • The fields are the default fields and the customized fields in your task layout.
    • Click the Mandatory checkbox to make it compulsory for the user to fill this field. 
  1. To insert a message, click Add and select Message. Enter the message in the text box and click Add.
  2. To reorder fields and messages, drag and drop the fields in your desired order. For example, if you want to display a message to the user before they fill out the fields, you can drag it before the fields.

After Transition

After Transition is configured to perform automated actions when a transition is complete.

  • Email Alerts

Configure email alerts and send them to specific users or teams when a transition is complete. For example, in the review process, an automated email is sent to the publisher when the content is approved. 

  1. Click Add next to Email Alerts
  2. Click Create Email Alert to create a new one and associate it with your transition. Know more about email alerts.
  3. You can also associate multiple email alerts with your transition. Select the email alerts that need to be sent and click Associate

  • Field Update

You can update specific field values when a transition is complete. For example, in the After Transition settings, you can set the % completion values for the task after each transition.

  1. Click Add next to Field Update.
  2. Select the field to be updated and set a value. 
  3. Click  to add more than one field and click - to delete the field.
  4. Click Save.
  • Associate Webhook to a Blueprint
You can associate a webhook to a blueprint transition. Create custom email alerts for task updates, add custom function and webhooks in the After Transition of your Blueprint.
  1. Click Add next to Webhooks.
  2. Select the Webhooks that have to be associated.
  3. Click Associate.
  4. You can remove a Webhook by clicking the close icon .
A maximum of 5 webhooks can be added to a blueprint transition.

Common Transition

A common transition is one which can be accessed from some or all statuses in the workflow.

For example, the review process can be put on hold at any time. In this blueprint, only the In Progress status can move to the On hold status via the Suspend transition. To allow other statuses to use this transition, Suspend must be enabled as a Common Transition from All statuses to On hold. The Suspend transition will be available in the task details page for all the status updates.

To Enable Common Transition:

  1. In the blueprint editor, click the transition to set as a common transition.
  2. In the transition settings, toggle to enable Common Transition.
    • If you have selected All statuses, the transition will be available in the task details page for all the status updates.
    • If you have selected specific statuses, the transition will be available in the task details page only for the selected status.

Parallel Transition

Parallel Transitions refers to two or more transitions that are executed parallelly. A status can be updated only if all the transitions are completed.

Add Parallel Transition

  1. In the blueprint editor, hover over a transition to which you want to add a parallel transition.
  2. Enable the toggle beside the Parallel Transition option.
  3. Enter the Transition Name.

A maximum of 4 parallel transitions are allowed.
A maximum of 2 parallel transitions sets can be created from a status.

Associate Parallel Transition

You can only create any number of independent transitions between two statuses. You can also convert independent transitions into parallel transitions.
  1. In the blueprint editor, hover over a transition.
  2. Click the icon to associate a transition.
  3. Select the transition that you would like to associate.
Disable parallel transition toggle before associating a transition.

Color coding a Transition

  1. In the blueprint editor, hover over a transition to which you want to add a parallel transition.
  2. Enable the toggle beside the Parallel Transition option.
  3. Enter the Transition Name.
  4. Click on the theme color beside the transition name.
  5. Select the preferred color.
  6. Click Save.

Publish a Blueprint

Once all the statuses and transitions you need are configured, you can publish the blueprint. When a blueprint is published, the tasks matching the blueprint criteria will follow the process workflow as defined in the blueprint.

When you're ready to do this, 

  1. Click Publish in the bottom left corner of the Blueprint Editor.
  2. If you don’t want to publish your blueprint, you can still save it as a draft and continue to configure the statuses and transition.
  3. To save the blueprint as a draft, click Cancel in the bottom left corner of the Blueprint Editor. In the pop-up which opens, click Save as draft.
  1. Any new task status added to the workflow will not go live until you publish the blueprint.
  2. You can only configure blueprint, not test the process workflow on task.

Blueprints are grouped based on the Task Layouts. They will be executed in the order in which they are listed in the grouping.

Points to remember before publishing a blueprint:

  • The status that connects the start state must always be Open, and the end status in the workflow must always be the Closed. Learn more 
  • All the statuses in the blueprint must be connected (via transitions) from the start state through to the end status. No status can be left disconnected in the blueprint.
  • All the statuses and transitions must have unique names. You cannot publish a blueprint with unnamed statuses and transitions.
  • Every status in the blueprint must have at least one incoming transition and one outgoing transition, except for the Closed status which can either have outgoing transitions or no outgoing transitions at all.  

Executing a Blueprint

A quick summary:

  • After creating a blueprint, drag and drop statuses from the Available Status section or create new statuses. Connect the nodes between two statuses to create a transition.
  • Configure all the transitions and publish the blueprint. The transitions will then be displayed as buttons in the task details page.
  • To perform a transition, click the transition button in the task details page. In the pop-up, enter the required details.
  • When a transition is performed, the task status will be updated as per the workflow.

Associate Blueprint

You can associate a blueprint to the tasks in a particular project, milestone, or task list.

  1. Navigate to Task Automation.
  2. Hover over the blueprint and click .
  3. Click Associate blueprint.
  4. Select a project to which you want to associate the blueprint. The blueprint will be applied to all the tasks in the project.
    • If you want to associate blueprint to the tasks in a particular milestone or task list, select them after selecting the project.
  1. Click on the  blueprint criteria checkbox if you want to associate blueprint to the tasks matching the blueprint criteria.
    • You cannot proceed if there are no tasks matching the blueprint criteria or a blueprint is already applied to the tasks.
  2. Click Next.
  3. Map the current task status to the status available in the blueprint.
    • The tasks associated with the current status will change as per the blueprint. 
  4. Click Map
You can also associate blueprint directly from a milestone, task list or a task.

Dissociate Blueprint

  1. Navigate to a project and click on the Task module.
  2. Click in the top right in the classic view.
  3. Select Dissociate Blueprint.
  4. Click Dissociate. The tasks in the project are no longer associated with the blueprint.

Reorder Blueprints

Blueprints are grouped based on the Task Layouts. They will be executed in the order in which they are listed in the grouping. You may reorder the blueprints if required.

  1. Drag and drop the blueprints in the order you want them to be executed.
  2. The first blueprint in the ordering will be applied to the tasks that match the blueprint criteria. If the blueprint criteria don't match, the next blueprint whose criteria matches the tasks will be executed. 

Clone a Blueprint

  1. Hover over the blueprint you want to clone and click .
  2. Click Clone and confirm your action. Name your blueprint after cloning.

Delete a Blueprint

  1. Hover over the blueprint you want to delete and click .
  2. Click Delete and confirm your action.

Enable or Disable a Blueprint

A blueprint is enabled by default when it is created. You can disable a blueprint so that the tasks do not enter the blueprint process. To disable, just uncheck the Enabled checkbox.

You cannot delete a blueprint while there are tasks active in the process. In this case, you can disable the blueprint.
See Also

    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now

            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION

                                      You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.

                                          Manage your brands on social media

                                            Zoho Desk Resources

                                            • Desk Community Learning Series

                                            • Digest

                                            • Functions

                                            • Meetups

                                            • Kbase

                                            • Resources

                                            • Glossary

                                            • Desk Marketplace

                                            • MVP Corner

                                            • Word of the Day

                                              Zoho Marketing Automation

                                                Zoho Sheet Resources


                                                    Zoho Forms Resources

                                                      Secure your business
                                                      communication with Zoho Mail

                                                      Mail on the move with
                                                      Zoho Mail mobile application

                                                        Stay on top of your schedule
                                                        at all times

                                                        Carry your calendar with you
                                                        Anytime, anywhere

                                                              Zoho Sign Resources

                                                                Sign, Paperless!

                                                                Sign and send business documents on the go!

                                                                Get Started Now

                                                                        Zoho TeamInbox Resources

                                                                                Zoho DataPrep Resources

                                                                                  Zoho DataPrep Demo

                                                                                  Get a personalized demo or POC

                                                                                  REGISTER NOW

                                                                                    Design. Discuss. Deliver.

                                                                                    Create visually engaging stories with Zoho Show.

                                                                                    Get Started Now

                                                                                                        • Related Articles

                                                                                                        • Manage Task Lists

                                                                                                          Managing task lists is essential for successful project management. Access various task list actions. Learn how to access the details page, add comments, re-order task lists, create templates, and sort task lists. Edit Task List Navigate to your ...
                                                                                                        • Phase List View

                                                                                                          Milestones have been renamed to phases. Phases are goal based targets in a project. Benefits Track, sort, and filter Phases based on your requirements Edit existing Phase Export Phases Inline edit the Phase fields Add Phase Navigate to the left ...
                                                                                                        • Widget Locations

                                                                                                          List of widget locations in Zoho Projects Location An extension's widget can be rendered in multiple locations inside the product. This key (location) defines where the widgets should be rendered. Zoho Projects provides a list of widget locations. ...
                                                                                                        • Task Automation in Zoho Projects - Concept

                                                                                                          Task automation in Zoho Projects simplifies and accelerates project management by automating routine tasks, and connecting your projects with other applications. Use cases HR: A HR manager in a software company uses Zoho Projects to manage employee ...
                                                                                                        • Checklist for Zoho Projects

                                                                                                          The Checklist for Zoho Projects extension lets you create a set of instantaneous to-do lists for your tasks and issues in Zoho Projects. With this extension, you can create both checklists and templates that can be used for any of your tasks and ...
                                                                                                          Wherever you are is as good as
                                                                                                          your workplace



                                                                                                            Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.


                                                                                                            Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.


                                                                                                            Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.

                                                                                                            CRM Tips

                                                                                                            Make the most of Zoho CRM with these useful tips.

                                                                                                              Zoho Show Resources