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
Use -o json for the full JSON response.
Get Release Details
Create a Release
| Flag | Description |
|---|
-n | Release name (required) |
-b | Branch to create the release from (required) |
-d | Release description |
--hotfix | Mark as a hotfix release |
--table-ids | Comma-separated table IDs to include |
-w | Workspace ID |
-o | Output format: summary or json |
Edit a Release
Delete a Release
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:
By default, the file is saved in the current directory. Specify a custom path with --output:
Import a Release
Import a previously exported release file into a workspace:
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
| Flag | Description |
|---|
-r | Release name (required) |
--env | Include environment variables |
--records | Include database records |
-w | Workspace ID |
Push as a New Release
| Flag | Description |
|---|
-n | Release name (required) |
-d | Release description |
--hotfix | Mark as a hotfix release |
--no-records | Skip importing table records |
--no-env | Skip environment variables |
-w | Workspace ID |
Xano