Skip to main content
on Anaconda.org help you organize packages and control their visibility. By applying labels to packages, you can facilitate the development cycle—separating development, testing, and production code—without impacting users who only want stable releases. Using Anaconda Client, package developers can create labels like dev for development, test for testing, or rc for release candidates.

​
Understanding labels

By default, conda only finds packages labeled main. If you don’t specify a label when uploading, your package automatically gets the main label. However, you can use other labels such as dev, test, or any-custom-label to effectively “hide” a package or package version from conda’s default search and install behavior. Users can still access the labeled package on Anaconda.org but must explicitly specify the label to find and install the package with conda.
Anaconda.org web URLs use /labels (plural) while conda commands use /label (singular).
The following examples use a of travis:

​
Using labels to control package visibility

The following steps explain how to apply a test label, which allows you to upload files without affecting your production-quality packages, then how to apply the main label to make it visible to conda.

​
Building and uploading the package

Use (Terminal on macOS/Linux) to perform the following steps:
  1. Start with a . In this example, we use a small public conda test package:
  2. Open the meta.yaml file by running the following command:
  3. Change the version number to 2.0. To save and close the meta.yaml file, press Ctrl+X, followed by Y.
  4. To build the package, turn off automatic Client uploading and then run the conda build command:
    You can check where the resulting file was placed by adding the --output option:
  5. Upload your test package to Anaconda.org using the Anaconda Client upload command. Add the --label option followed by your label (in this case, test), which tells Anaconda.org to make the upload visible only to users who specify that label:
Now you can see that even when you search conda main, you do not see the 2.0 version of the test package. This is because you need to tell conda to look for your new test label.

​
Testing the discoverability of the package

  1. Add the --override argument, which tells conda not to use any in your ~/.condarc file. Without specifying the label and package name, the 2.0 version is not discoverable:
    Once the label and package are specified, the 2.0 can be found:
  2. You can give the label <USERNAME>/label/test to your testers, where <USERNAME> is your username.
  3. Once they finish testing, you might then want to copy the test packages back to your main label:
    You can also manage your package labels from your dashboard at https://anaconda.org/USERNAME/conda-package, where <USERNAME> is your username. Your version 2.0 is now in main:
If you use anaconda-client 1.7 or higher, you can use anaconda move to move packages from one label to another: