# Releases

A release is a frozen application state, that allows you to package and ship a certain state of your application to a certain environment.

{% hint style="warning" %}
Releases are only available on Pro Projects and not on Free Tier.
{% endhint %}

## Creating a new Release

1. Navigate to **Application Layer -> Releases**.
2. Click on **Review & Deploy**.
3. Select the latest changes you would want to deploy and click **Next**.
4. Chose the environment you want to deploy on, pass the version tag (**such as v1.0.0**) and click **Deploy**.

Your release your be instantly live on the environment you have released on.

{% hint style="info" %}
For more information on Instant Deployments, [<mark style="color:blue;">**check here**</mark>](/advanced-guide/performance-considerations/instant-deployments.md).
{% endhint %}

## Promoting a release to another Environment

Often, you would want to bump your release X from one environment to another, for example from staging to production. To do this -

1. Click on the **3 dot menu button** of the release you want to bump.
2. Select **Promote release**.
3. Select the environment you want to promote the release to, and click **Promote**.


---

# 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://docs.cosmocloud.io/resources/releases.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.