.. _ref_commands_release:

release
=======

Release <snap-name> at <revision> to the selected store <channels>.
<channels> is a comma-separated list of valid channels in the store.

The <revision> must exist in the store; to see available revisions,
run ``snapcraft list-revisions <name>``.

The channel map will be displayed after the operation takes place. To see
the status map at any other time run ``snapcraft status <name>``.

The format for a channel is ``[<track>/]<risk>[/<branch>]`` where

    - <track> is used to have long-term release channels. It is implicitly
      set to ``latest``. If this snap requires one, it can be created by
      request by having a conversation on https://forum.snapcraft.io
      under the *store* category.
    - <risk> is mandatory and must be one of ``stable``, ``candidate``, ``beta``
      or ``edge``.
    - <branch> is optional and dynamically creates a channel with a
      specific expiration date.

Examples:
    snapcraft release my-snap 8 stable
    snapcraft release my-snap 8 stable/my-branch
    snapcraft release my-snap 9 beta,edge
    snapcraft release my-snap 9 lts-channel/stable
    snapcraft release my-snap 9 lts-channel/stable/my-branch

Usage
-----

:command:`snapcraft release [options] <name> <revision> <channels>`

Required
--------

``name``
   The snap name to release.
``revision``
   The revision to release.
``channels``
   The comma-separated list of channels to release to.

Options
-------

``--progressive``
   Set a release progression to a certain percentage [0<=x<=100].

Global options
--------------

``-h`` or ``--help``
   Show this help message and exit.
``-q`` or ``--quiet``
   Only show warnings and errors, not progress.
``-v`` or ``--verbose``
   Show debug information and be more verbose.
``--verbosity``
   Set the verbosity level to 'quiet', 'brief', 'verbose', 'debug' or 'trace'.
``-V`` or ``--version``
   Show the application version and exit.