# Using process flow labels

## Introduction

Existing process flow labels can be [applied](#applying-labels-to-a-process-flow) and [removed](#removing-labels-to-a-process-flow) for a process flow via process flow settings. You can define labels for any purpose - there's no right or wrong way to use them. For example, you might define labels to indicate the development status of a flow, whether it's a '[master' flow for virtual environments](https://doc.wearepatchworks.com/product-documentation/virtual-environments/implementing-virtual-environments/creating-a-master-process-flow), etc. &#x20;

As the number of process flows grows for your organisation, it can also be useful to [filter the main process flows list by specific labels](#filtering-process-flows-by-label).&#x20;

## Applying labels to a process flow

{% stepper %}
{% step %}
**Access the required process flow**

[Ac](https://doc.wearepatchworks.com/product-documentation/process-flows/accessing-your-process-flows)[cess the process flow](https://doc.wearepatchworks.com/product-documentation/process-flows/accessing-your-process-flows) that you want to update.&#x20;

{% hint style="info" %}
Labels are associated with the process flow as a whole, not a specific version. As such, it doesn't matter which version of the process flow you display on the canvas to make this update.
{% endhint %}
{% endstep %}

{% step %}
**Open process flow settings**

Click the 'cog' icon in the [canvas](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/the-process-flow-canvas) toolbar to access settings for this process flow:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FF4o0Sl9b5NVF7u8nY43z%2Fadd%20process%20flow%20label%201.png?alt=media&#x26;token=27a4b740-2c34-42ba-bb22-04249e8907dd" alt="" width="310"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**View existing labels**

Click in the `labels` field - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F2iflDS0ODOwExJ2XrFUl%2Fapply%20process%20flow%20label%202.png?alt=media&#x26;token=7093b5f3-542a-464e-af9f-bcbc541de790" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
If you don't see a label that you need, use the `create label` option to [add it now](https://doc.wearepatchworks.com/product-documentation/process-flows/managing-process-flows/process-flow-labels/adding-new-process-flow-labels).
{% endhint %}
{% endstep %}

{% step %}
**Apply the required label(s)**

Select any labels that you want to apply (you can add a single label or multiple labels at the same time):

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FUvUfbXr8ovJzEWJTYHKY%2Fapply%20process%20flow%20label%203b.png?alt=media&#x26;token=8a989faf-e4e7-44a3-995c-8d87c3f802dd" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Save settings**

Save settings when you've finished making updates.
{% endstep %}
{% endstepper %}

## Removing labels from a process flow

{% stepper %}
{% step %}
**Access the required process flow**

[Ac](https://doc.wearepatchworks.com/product-documentation/process-flows/accessing-your-process-flows)[cess the process flow](https://doc.wearepatchworks.com/product-documentation/process-flows/accessing-your-process-flows) that you want to update.&#x20;

{% hint style="info" %}
Labels are associated with the process flow as a whole, not a specific version. As such, it doesn't matter which version of the process flow you display on the canvas to make this update.
{% endhint %}
{% endstep %}

{% step %}
**Open process flow settings**

Click the 'cog' icon in the [canvas](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/the-process-flow-canvas) toolbar to access settings for this process flow:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FF4o0Sl9b5NVF7u8nY43z%2Fadd%20process%20flow%20label%201.png?alt=media&#x26;token=27a4b740-2c34-42ba-bb22-04249e8907dd" alt="" width="310"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Remove labels**

Move down to the labels panel and click the 'cross' icon associated with any labels that you want to remove. For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FS17pOTMVCV8c4pYLTgaN%2Fremove%20process%20flow%20label%201a.png?alt=media&#x26;token=4d6b88ef-1af1-4059-beca-99b812f617c7" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Save settings**

Save settings when you've finished making updates.
{% endstep %}
{% endstepper %}

## Filtering process flows by label

Any labels that have been applied to process flows are displayed in the [main process flows list](https://doc.wearepatchworks.com/product-documentation/process-flows/accessing-your-process-flows) - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FcZ7MOzH0ezjfBf8ljTe8%2Ffilter%20by%20process%20flow%20label%200.png?alt=media&#x26;token=a6b9b7a2-1863-4bc6-b4bc-0c1c956911c9" alt=""><figcaption></figcaption></figure></div>

To filter this list by specific labels, follow the steps below.

{% stepper %}
{% step %}
**Access filter options**

Click the `filter` icon associated with the `labels` column:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7SyB1WErysmcym0AUV6o%2Ffilter%20by%20process%20flow%20label%201.png?alt=media&#x26;token=3ed5a900-cbd2-4af3-b42f-94bc43e33397" alt=""><figcaption></figcaption></figure></div>

Filter options are displayed:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F8SMPfFMSQEZjMqDFrU4p%2Ffilter%20by%20process%20flow%20label%202.png?alt=media&#x26;token=3f6a1e59-a255-448f-b5b6-e1b73845db8a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Choose labels for the filter**

Click in the `select labels` field and select the label(s) that you want to apply for filtering. The list of flows updates immediately to reflect your selections, for example: &#x20;

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FraVsT6IaCb9u76b4Gj42%2Ffilter%20by%20process%20flow%20label%204.png?alt=media&#x26;token=75b5c43b-aa00-4720-99a3-a79979e9acaf" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}
