Manpage logo

glab-release-upload - Upload release asset files or links to a GitLab release.

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  OPTIONS INHERITED FROM PARENT COMMANDS  EXAMPLE  SEE ALSO 

NAME

glab-release-upload - Upload release asset files or links to a GitLab release.

SYNOPSIS

glab release upload [...] [flags]

DESCRIPTION

Upload release assets to a GitLab release.

Define the display name by appending ’#’ after the filename. The link type comes after the display name, like this: ’myfile.tar.gz#My display name#package’

OPTIONS

-a, --assets-links=""

JSON string representation of assets links, like: --assets-links=’[{"name": "Asset1", "url":"https://<domain>/some/location/1", "link_type": "other", "direct_asset_path": "path/to/file"}]’.

--package-name="release-assets"

The package name to use when uploading the assets to the generic package release with --use-package-registry.

--use-package-registry[=false]

Upload release assets to the generic package registry of the project. Alternatively to this flag you may also set the GITLAB_RELEASE_ASSETS_USE_PACKAGE_REGISTRY environment variable to either the value true or 1. The flag takes precedence over this environment variable.

OPTIONS INHERITED FROM PARENT COMMANDS

-h, --help[=false]

Show help for this command.

-R, --repo=""

Select another repository. Can use either OWNER/REPO or GROUP/NAMESPACE/REPO format. Also accepts full URL or Git URL.

EXAMPLE

# Upload a release asset with a display name. ’Type’ defaults to ’other’.
$ glab release upload v1.0.1 ’/path/to/asset.zip#My display label’

# Upload a release asset with a display name and type.
$ glab release upload v1.0.1 ’/path/to/asset.png#My display label#image’

# Upload all assets in a specified folder. ’Type’ defaults to ’other’.
$ glab release upload v1.0.1 ./dist/*

# Upload all tarballs in a specified folder. ’Type’ defaults to ’other’.
$ glab release upload v1.0.1 ./dist/*.tar.gz

# Upload release assets links specified as JSON string
$ glab release upload v1.0.1 --assets-links=’
[
{
"name": "Asset1",
"url":"https://<domain>/some/location/1",
"link_type": "other",
"direct_asset_path": "path/to/file"
}
]’

SEE ALSO

glab-release(1)


Updated 2026-06-01 - jenkler.se | uex.se