# 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](/product-documentation/virtual-environments/implementing-virtual-environments/creating-a-master-process-flow.md), 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](/product-documentation/process-flows/accessing-your-process-flows.md)[cess the process flow](/product-documentation/process-flows/accessing-your-process-flows.md) 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](/product-documentation/process-flows/building-process-flows/the-process-flow-canvas.md) toolbar to access settings for this process flow:

<div align="left"><figure><img src="/files/i0Ejd09TTrSIUXidtjCA" 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="/files/lOgRXJY42ytNhxgKpZNR" 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](/product-documentation/process-flows/managing-process-flows/process-flow-labels/adding-new-process-flow-labels.md).
{% 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="/files/f0g4kiVc691fXsQzcRMd" 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](/product-documentation/process-flows/accessing-your-process-flows.md)[cess the process flow](/product-documentation/process-flows/accessing-your-process-flows.md) 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](/product-documentation/process-flows/building-process-flows/the-process-flow-canvas.md) toolbar to access settings for this process flow:

<div align="left"><figure><img src="/files/i0Ejd09TTrSIUXidtjCA" 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="/files/jqfvLdNskoEU5vw4ut5W" 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](/product-documentation/process-flows/accessing-your-process-flows.md) - for example:

<div align="left"><figure><img src="/files/cHMYGPsu2SQ8aGj3wCkL" 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="/files/7clN0IqpsNMa7bZuE02L" alt=""><figcaption></figcaption></figure></div>

Filter options are displayed:

<div align="left"><figure><img src="/files/DbGhNf3HY5bDDU13rjzC" 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="/files/iiWt6dvZdYrVx6NSF5Co" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/process-flows/managing-process-flows/process-flow-labels/using-process-flow-labels.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
