.. _ref_commands_list-tracks:

list-tracks
===========

Track status, creation dates and version patterns are returned alongside the
track names in a space formatted table.

Possible Status values are:

- active, visible tracks available for installation
- default, the default track to install from when not explicit
- hidden, tracks available for installation but unlisted
- closed, tracks that are no longer available to install from

A version pattern is a regular expression that restricts a snap revision
from being released to a track if the version string set does not match.

Usage
-----

:command:`snapcraft list-tracks [options] <name>`

Required
--------

``name``
   The snap name to request the information from on the Snap Store.


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.