# Creating a package

## Introduction

To create a new package, you start by adding the name and (optionally) a description, then select your required process flow versions.

## Need to know

* A package can contain *one* version of any given process flow. If you need to deploy different versions of the same process flow, you must create one package for each version.
* Process flows are associated with a package for deployment purposes only. After a flow version is deployed, it won't be affected by any subsequent actions taken with the package - for example, if a package is [removed](/product-documentation/virtual-environments/virtual-environment-packages/managing-packages/deleting-a-package.md), any associated flow deployments won't change.

## The steps

{% stepper %}
{% step %}
**Access virtual environment packages**

[Log in to the dashboard](https://app.wearepatchworks.com/virtual-environments) and select `virtual environments` ➤ `packages` from the left-hand navigation menu.
{% endstep %}

{% step %}
**Create a new package**

Click the `create` button in the top-right corner:

<figure><img src="/files/y7ONFrGhVC8ex7UHCCKA" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Provide basic details for the package**

Enter a `name` and (optionally) `notes` for this environment, then click the `create` button:

<figure><img src="/files/zeAYtkHAZwpi9hVGNon8" alt=""><figcaption></figcaption></figure>

...package details are displayed:

<figure><img src="/files/vKIw2YULedqglXHKtQNS" alt=""><figcaption></figcaption></figure>

Here, the page is split into upper and lower panels with `flows` at the top and `deployments` (of this package) below. As this is a new package, both panels will be empty.&#x20;
{% endstep %}

{% step %}
**Add flows**

To add your first process flow to the package, click the `add flow` button:

<figure><img src="/files/ajjzL1n5qkTvkAZsjHul" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Select a process flow**

Select a process flow that you want to add to this package (all defined process flows are listed):

<figure><img src="/files/GSS9o04WHCPgkNw9MuAh" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Select a process flow version**

Choose which version of the selected process flow to add:

<figure><img src="/files/qyOGHaU3byrJnhm0vkTK" alt=""><figcaption></figcaption></figure>

All existing [versions](/product-documentation/virtual-environments/implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment/understanding-flow-versioning-for-virtual-environments.md) of the selected flow are available for selection, together with a `latest version` option.&#x20;

Selecting `latest version` results in the latest version of the process flow being deployed whenever you choose to deploy this package.&#x20;

{% hint style="info" %}
A package can contain *one* version of any given process flow. If you need to deploy different versions of the same process flow, you must create one package for each version.
{% endhint %}
{% endstep %}

{% step %}
**Confirm your selections**

Having chosen the required process flow and version, click the `add flow` button to confirm your selections:

<figure><img src="/files/3WzcXF8XSXud9JGQDo5N" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Add more flows as needed**

Repeat steps 4-7 for any other process flows that you want to add. When you're finished, use the breadcrumb trail at the top of the page to exit back to the packages list (where you can select options to [manage this package](/product-documentation/virtual-environments/virtual-environment-packages/managing-packages.md)):

<div align="left"><figure><img src="/files/lhKU8PEnlQbGqY8Wiv9u" 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/virtual-environments/virtual-environment-packages/creating-a-package.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.