Business process designer > BPMN processes > Graphical elements / Manage Status

Manage Status

manage_status The Manage Status element is used only in the business processes that involve apps with customized statuses. It allows you to track the process progress and also determines the app status at a particular stage of the process.

For example, you can create an Contracts app and set up an associated business process for document approval. By setting up statuses, you can track at what stage of the document life-cycle an contract currently is. As the process progresses, the contract will automatically acquire different statuses: Approved, Signed, Rejected, etc, providing clear information on how the work is being done.


Specify the statuses

To set up this element, you need to specify the statuses first. You can do it in the app's settings or right in the Statuses tab of the process designer.

начало внимание

Please note that this tab is only available in business processes associated with an app. In global company processes and processes associated with a workspace, this tab is unavailable.

конец внимание

In Status field, we have described how statuses can be specified in the app's settings. In the process designer, it is done in the same way.

Go to the Statuses tab.


Check the Add Status field option and then enter status names. Do not forget to select the final status and hide it from the kanban board, if necessary.

Set up the Manage Status activity  

Open the process diagram. On the right pane, click on the gear icon to open System elements. Drag the Manage status element to the diagram and place it where a change of status is required.


Double-click on the element to open its settings.

If the process is associated with an app, the Variable field will already contain the context variable representing the app.

In the Set status drop-down list select the required value and click Save.


If the Variable field is empty, select a variable in the drop-down list or add a new variable that will represent an app with configured statuses.

If you are setting up status change for the Deals app, an additional Reason for rejection field will appear if the Lost status is selected.        

Changing statuses of two or more apps in one process

Sometimes you will use several apps in one process. The approval process mentioned above describes the stages of approving a contract. Contracts belong to the Order Management workspace, which may also store other apps, for instance, Customers, Orders, Claims. Each of these apps might have its own set of statuses.


When the contract’s status changes, it seems reasonable to change the contractor’s status, too. For example, once the contract is signed, the contractor’s status can change from Contract approval to Order fulfillment.

This way, both of these apps will be included in one process, and the statuses of both apps will change as the process progresses.

Here is how you can set this up:


  1. In process designer, go to the Context tab. Add a new variable to represent the Contractoror app.


  1. Place new Manage status elements where necessary, for instance, before and after the Sign the contract task.


  1. Double-click on the element to open its settings. In the Variable field, select Contractor. In the drop-down list select the required status and click Save.

ms 7

Now you only have to decide how the Contractors variable added on step 1 shall be filled in.

You can place the variable on a task form. In this case, the employee performing this task will be asked to select a specific contractor on the task form.

Sometimes users specify the contractor directly in the contract when adding a new app item. In this case, the contractor’s details shall be sent from the Contracts app to the variable created in step 1. To do that, use the Assign value activity.

Found a typo? Highlight the text, press ctrl + enter and notify us