# Viewing flow deployments

## Introduction

The `flow deployments` page lists all flow deployments (current and historic) across all your virtual environments, and also deployments made to `no environment`.  For example:

<div align="left"><figure><img src="/files/T7YUehKen0jex3S0ykyj" alt=""><figcaption></figcaption></figure></div>

Every deployment completed, irrespective of the deployment mechanism (i.e. deployed [individually](/product-documentation/virtual-environments/implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment.md) or via a [package](/product-documentation/virtual-environments/virtual-environment-packages/managing-packages/deploying-a-package.md)), is listed.&#x20;

{% hint style="info" %}
If a flow deployment is [deleted](/product-documentation/virtual-environments/managing-virtual-environments-versions-and-flows/managing-virtual-environment-flow-deployments/deleting-a-process-flow-deployment-from-a-virtual-environment.md) from the associated virtual environment, the corresponding entry is removed from this list. Otherwise, deployments remain for all time.
{% endhint %}

## Accessing the flow deployments page

To access the `flow deployments` page, select `virtual environments` ➤ `deployments` from the left-hand navigation menu:

<div align="left"><figure><img src="/files/eOPF9fBVDTinI2S02Q4w" alt="" width="229"><figcaption></figcaption></figure></div>

## Understanding the flow deployments page

By default, flow deployments are listed in chronological order by deployment date/time, with the most recent deployments first.&#x20;

## Working with flow deployments

You can use [search and filter options](#search-and-filter-options) to refine the list, and you can use [actions](#flow-deployment-actions) to perform given tasks. Each entry is listed under a series of headings - for example:

<div align="left"><figure><img src="/files/AoCor1JOS434USomZAlg" alt=""><figcaption></figcaption></figure></div>

These headings are summarised below:

<table><thead><tr><th width="164.5546875">Heading</th><th width="446.23828125">Summary</th><th>Sort &#x26; filter?<select><option value="HWMyw9zzW4lm" label="can be filtered" color="blue"></option><option value="T9FCKIy16WQy" label="can be sorted" color="blue"></option><option value="TPDe7gGrlYjH" label="n/a" color="blue"></option></select></th></tr></thead><tbody><tr><td>Flow</td><td>The process flow name, displayed as a hyperlink (click the link to access the associated flow). If a deployment is associated with a flow version that has been subsequently deleted, the name will include a <code>deleted</code> marker. </td><td><span data-option="T9FCKIy16WQy">can be sorted</span></td></tr><tr><td>Version</td><td>The process flow version that was deployed.</td><td><span data-option="T9FCKIy16WQy">can be sorted</span></td></tr><tr><td>Package</td><td>If the deployment was made via a <a href="/pages/vA7dSxodDGw4rcUx8h54">package</a>, the package name is displayed as a hyperlink (click the link to access the associated package).</td><td><span data-option="HWMyw9zzW4lm">can be filtered</span></td></tr><tr><td>Virtual environments</td><td>The name of the target virtual environment (if applicable).</td><td><span data-option="HWMyw9zzW4lm">can be filtered</span></td></tr><tr><td>Deployed at</td><td>The date and time that this flow version was last deployed to the associated virtual environment. <br><br>Typically, this won't change. However, if you were to deploy a flow version, then delete that deployment and subsequently re-deploy the same version to the same virtual environment, this value would be updated. </td><td><span data-option="T9FCKIy16WQy">can be sorted</span></td></tr><tr><td>Enabled at</td><td>The date and time that the deployment was last enabled. When a process flow is deployed, it is enabled automatically, so typically this date/time is the same as the <code>deployed at</code> date/time.<br><br>However, if you were to <a href="/pages/QJn3I6Ens3cFWBGOJZMh">deploy a flow version</a>, then <a href="/pages/S7ZXvG3q7xvcFezsI1dS">disable</a> that deployment and subsequently re-enable it, this value would be updated. </td><td><span data-option="T9FCKIy16WQy">can be sorted</span></td></tr><tr><td>Enabled by</td><td>The username of the person who last enabled this deployment. <br><br>Typically, this will be the same as the <code>deployed by</code> value. However, if you were to <a href="/pages/S7ZXvG3q7xvcFezsI1dS">disable</a> a deployment and subsequently it is re-enabled by a different user, this value would be updated. </td><td><span data-option="TPDe7gGrlYjH">n/a</span></td></tr><tr><td>...</td><td>Access <a href="#flow-deployment-actions">actions that can be taken with the selected flow deployment</a>.</td><td><span data-option="TPDe7gGrlYjH">n/a</span></td></tr></tbody></table>

### Search & filter options

Use the `search` field at the top of the page to search by any part of a process flow name. For example:

<div align="left"><figure><img src="/files/WSUA7eeKuI1NgfEuIQev" alt=""><figcaption></figcaption></figure></div>

You can also filter the list by `package` and/or `virtual environment`, using filter options associated with these columns. For example:

<div align="left"><figure><img src="/files/ZI8782gtC9F3QOhxQinI" alt=""><figcaption></figcaption></figure></div>

Note that:

* Any virtual environments with at least one flow deployment (irrespective of whether those deployments are enabled or disabled) will be available for selection.
* Any packages deployed at least once will be available for selection.

### Flow deployment actions

The ellipsis associated with each deployment provides access to the following actions:

<table><thead><tr><th width="198.3359375">Option</th><th>Summary</th></tr></thead><tbody><tr><td>Disable / Enable</td><td><p>Availability depends on whether the selected deployment is currently <a href="/pages/S7ZXvG3q7xvcFezsI1dS">enabled or disabled</a>, so you set the reverse state. Note that: <br></p><ul><li>If a deployment is <code>enabled</code>, it will run in the associated virtual environment.</li><li>If a deployment is <code>disabled</code>, it will NOT run in the associated virtual environment.</li></ul></td></tr><tr><td>Delete</td><td><a href="/pages/GCXZ3yan8tOdpSqWGASD">Delete the selected deployment</a>. This removes the flow version from the associated virtual environment and sets the status to <code>inactive</code>.</td></tr></tbody></table>


---

# 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/virtual-environments/managing-virtual-environments-versions-and-flows/managing-virtual-environment-flow-deployments/viewing-flow-deployments.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.
