.. _ref_commands_upload:

upload
======

Upload a charm or bundle to Charmhub.

Push a charm or bundle to Charmhub where it will be verified.
This command will finish successfully once the package is
approved by Charmhub.

In the event of a failure in the verification process, charmcraft
will report details of the failure, otherwise it will give you the
new charm or bundle revision.

Upload will take you through login if needed.


Usage
-----

:command:`charmcraft upload [options] <None>`

Required
--------

``None``
   The charm or bundle to upload.

Options
-------

``--format``
   Produce the result in the specified format (currently only 'json').
``--name``
   Name of the charm or bundle on Charmhub to upload to.
``--release``
   The channel(s) to release to (this option can be indicated multiple times).
``--resource``
   The resource(s) to attach to the release, in the <name>:<revision> format (this option can be indicated multiple times).

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.