.. _ref_commands_promote:

promote
=======
Promote a charm from one channel to another on Charmhub.

Promotes the current revisions of a charm in a specific channel, as well as
their related resources, to another channel.

The most common use is to promote a charm to a more stable risk value on a
single track:

    ``charmcraft promote --from-channel=candidate --to-channel=stable``


Usage
-----

:command:`charmcraft promote [options] <from-channel> <to-channel>`

Required
--------

``from-channel``
   The channel to promote from.
``to-channel``
   The channel to promote to.

Options
-------

``--name``
   The name of the charm to promote. If not specified, the name will be inferred from the charm in the current directory.
``--yes``
   Use non-interactive mode, answering yes to most questions.

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.