# Releases

A **Release** is a bundle of resources from your workspace that you want to deploy together.

> When you create a release, you select exactly which flows, connectors, widgets, and API keys you want included.

### **Creating a Release**

* Go to **Settings → Deployment → Releases**.
* Click **Create Release**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FpsoiY2azmDL6bDWEWEnr%2Fimage.png?alt=media&#x26;token=77cf679a-5f90-4f37-99fb-2e2f9fc7cd67" alt=""><figcaption></figcaption></figure>

* Fill out the **General Info**:
  * **Release Name**
  * **Description** – explain what this release includes
  * **Source Workspace** – choose the workspace from which you want to pull resources

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FtwO8NUqkN9kkGDLXdkfe%2Fimage.png?alt=media&#x26;token=0053d703-38dc-42cd-b8c0-b5eab0f8fa24" alt=""><figcaption></figcaption></figure>

* Select resources to include:
  * **Flows**: choose from *Live* or *Drafts*
  * **Connectors**: select any number of connectors
  * **Widgets**: pick the widgets you want to move
  * **API Keys & Configurations**: add as needed

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FCkmDJFGFmGtlyx3rtWGi%2Fimage.png?alt=media&#x26;token=19e854b6-2289-4d3f-af82-f3c2039e464a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FcwRQHpS3oANYtOKLIxkY%2Fimage.png?alt=media&#x26;token=06eb570e-131a-4829-8af2-ea40d4fa81bc" alt=""><figcaption></figcaption></figure>

* Click **Create Release** (bottom-right).

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FA71fzxl3UPTpSVq4eaFD%2Fimage.png?alt=media&#x26;token=0b9048d5-972f-4cfb-bd5e-10cd4bcbb45d" alt=""><figcaption></figcaption></figure>

### **After Creating a Release**

You will land on the **Release Details & Comparison** page, where you can:

#### **Compare Releases**

* Select another release to compare against.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2FTQh2U3Jzy24mFSsMRH7e%2Fimage.png?alt=media&#x26;token=a860ade8-c994-4858-b0af-eeea9104abcf" alt=""><figcaption></figcaption></figure>

* View differences such as:
  * Added or removed flows
  * Widget changes
  * Updated configurations or API keys

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2F3b9oYZxv47wudQJ66BNp%2Fimage.png?alt=media&#x26;token=1aab71f8-c135-4343-b818-cb348d2f31d6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This helps you validate changes before deploying.
{% endhint %}

#### **Create Another Release**

* Use the **Create Release** button again to generate a new version and compare it with the previous one.
