Skip to main content
Releases are versioned snapshots of a workspace branch that can be deployed to tenants. They enable controlled rollouts and version management across your tenant infrastructure.
Release commands require a workspace ID, either from your profile or via the -w flag. All release commands use release names (e.g., v1.0), not IDs.

List Releases

Terminal
xano release list
Use -o json for the full JSON response.

Get Release Details

Terminal
xano release get v1.0

Create a Release

Terminal
xano release create -n "v1.0" -b v1
FlagDescription
-nRelease name (required)
-bBranch to create the release from (required)
-dRelease description
--hotfixMark as a hotfix release
--table-idsComma-separated table IDs to include
-wWorkspace ID
-oOutput format: summary or json

Edit a Release

Terminal
xano release edit v1.0 -n "v1.0-final" -d "Updated description"

Delete a Release

Terminal
xano release delete v1.0
Add -f to skip the confirmation prompt.
Deleting a release is permanent and cannot be undone.

Export a Release

Download a release as a .tar.gz file:
Terminal
xano release export v1.0
By default, the file is saved in the current directory. Specify a custom path with --output:
Terminal
xano release export v1.0 --output ./backups/my-release.tar.gz

Import a Release

Import a previously exported release file into a workspace:
Terminal
xano release import --file ./my-release.tar.gz

Pull & Push

You can pull a release down as local XanoScript files, or push local files as a new release. This works the same way as workspace pull & push, but targets a specific release instead of a branch.

Pull a Release

Terminal
xano release pull ./my-release -r v1.0
FlagDescription
-rRelease name (required)
--envInclude environment variables
--recordsInclude database records
-wWorkspace ID

Push as a New Release

Terminal
xano release push ./my-release -n "v2.0"
FlagDescription
-nRelease name (required)
-dRelease description
--hotfixMark as a hotfix release
--no-recordsSkip importing table records
--no-envSkip environment variables
-wWorkspace ID