docs/admin-guide/guides/project-releases.mdx
Project Releases allow you to sync flows, connections, and tables between different projects—essential for teams that want to develop in one environment and deploy to another with confidence.
<Tip> **Example:** Build and test your automations in a **Staging** project, then seamlessly promote them to **Production** when ready. Simply navigate to your Production project → **Releases** → create a release from Staging, and all your changes will be applied instantly. </Tip> ## OverviewThere are three ways to create a release:
| Source | Description |
|---|---|
| Git | Pull changes from a connected Git repository |
| Project | Copy flows from another project in your instance |
| Rollback | Restore a previous release state |
In your project dashboard, go to settings then to Environments and hit the enable button.
Navigate to the Releases page from your project sidebar to view all releases and create new ones.
If you want to use Git to track your changes, you'll need to connect a Git repository first. This requires the Environments feature to be enabled.
Apply changes from flows, connections and tables in one project to another.
<Steps> <Step title="Open Create Release Menu"> Click the **Create Release** dropdown button. </Step> <Step title="Select From Project"> Choose **From Project** from the dropdown menu. </Step> <Step title="Select Source Project"> Choose the project you want to copy flows, connections and tables from. </Step> <Step title="Review and Apply"> Review the changes, and click **Apply Changes**. </Step> </Steps><Warning> New connections created during a release are placeholders and need to be reconnected with valid credentials after the release is applied. </Warning>
If your project is connected to a Git repository, you can push all your flows, connections, and tables to Git.
<Steps> <Step title="Click Push Everything"> Click the **Push Everything** button on the releases page. </Step> <Step title="Enter Commit Message"> Write a descriptive commit message explaining your changes. </Step> <Step title="Push"> Click **Push** to send all published flows to the Git repository. </Step> </Steps>You can also push specific flows or tables to Git without pushing everything. <Warning> You can only push published flows to git </Warning> <Steps> <Step title="Select Items"> Navigate to your flows or tables and select the items you want to push. </Step> <Step title="Open Push Dialog"> Click the Push to Git option. </Step> <Step title="Enter Commit Message"> Provide a commit message describing what you're pushing. </Step> <Step title="Push"> Click Push to send the selected items to Git. </Step> </Steps>
If something goes wrong after applying a release, you can easily rollback to a previous state.
<Steps> <Step title="Find the Release"> Locate the release you want to rollback to in the releases list. </Step> <Step title="Click Rollback"> Click the rollback icon (↩) next to the release. </Step> <Step title="Review Changes"> Review the changes that will be applied to restore that release state. </Step> <Step title="Apply Rollback"> Select the changes to include and click **Apply Changes**. </Step> </Steps>Each release in the list shows:
| Column | Description |
|---|---|
| Name | The name you gave the release |
| Source | Where the release came from (Git, Project, or Rollback) |
| Imported At | When the release was created |
| Imported By | The user who created the release |
Click on any release to view its full details.
When creating a release, you'll see a preview of all changes:
To create and manage releases, you need the Write Project Release permission. Contact your instance administrator if you don't have access to the releases feature.