> ## Documentation Index > Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Labels Labels (Part of the URLs on Anaconda.org where conda looks for packages.) 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. > [!WARNING] > > Anaconda.org web URLs use `/labels` (plural) while conda commands use `/label` (singular). The following examples use a Namespace (Each user and organization has their own location called a 'namespace' where they can host packages. You can view the public packages in a user or organization's namespace by navigating to their user page.) of `travis`: | Web Interface | Conda Command | What it contains | | :- | :- | :- | | `anaconda.org/travis` | `conda install --channel travis ` | Default packages (`main` label only) | | `anaconda.org/travis/labels/main` | `conda install --channel travis/label/main ` | Explicitly accessing `main` label | | `anaconda.org/travis/labels/dev` | `conda install --channel travis/label/dev ` | Development packages | | `anaconda.org/travis/labels/test` | `conda install --channel travis/label/test ` | Testing packages | ## 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 Anaconda Prompt (A command-line application included with Windows installations of Anaconda Distribution and Miniconda. Find it by searching 'Anaconda Prompt' in the Windows Start menu.) (Terminal on macOS/Linux) to perform the following steps: 1. Start with a conda package (An archive file containing a software program and all its dependencies for easy installation. Conda automatically handles dependency tracking across different platforms, eliminating the need to manually install each component separately.). In this example, we use a small public [conda test package](https://github.com/Anaconda-Platform/anaconda-client/tree/master/example-packages/conda): ```sh theme={null} git clone https://github.com/Anaconda-Platform/anaconda-client/ cd anaconda-client/example-packages/conda/ ``` 2. Open the `meta.yaml` file by running the following command: ```sh theme={null} nano meta.yaml ``` 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: ```sh theme={null} conda config --set anaconda_upload no conda build . ``` > [!TIP] > > You can check where the resulting file was placed by adding the `--output` option: > > ```sh theme={null} > conda build . --output > ``` 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: ```sh theme={null} anaconda upload .tar.bz2 --label test ``` Comments Replace \ with the correct file path and package name. 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 channels (A location (URL or file path) in a repository where conda looks for packages.) in your `~/.condarc` file. Without specifying the label and package name, the `2.0` version is not discoverable: ```sh theme={null} conda search --override --channel conda-package ``` Comments Replace \ with your username. Once the label and package are specified, the `2.0` can be found: ```sh theme={null} conda search --override --channel /label/test conda-package ``` Comments Replace \ with your username. 2. You can give the label `/label/test` to your testers, where `` is your username. 3. Once they finish testing, you might then want to copy the `test` packages back to your `main` label: ```sh theme={null} anaconda label --copy test main ``` You can also manage your package labels from your dashboard at `https://anaconda.org/USERNAME/conda-package`, where `` is your username. Your version `2.0` is now in `main`: ```sh theme={null} conda search --override --channel conda-package ``` Comments Replace \ with your username. If you use `anaconda-client` 1.7 or higher, you can use `anaconda move` to move packages from one label to another: ```sh anaconda move theme={null} anaconda move --from-label --to-label ``` ```sh Examples theme={null} # Move an entire set of files to a new label anaconda move --from-label main --to-label dev myusername/numpy/1.21.0 # Move a single file to a new label anaconda move --from-label main --to-label dev myusername/numpy/1.21.0/numpy-1.21.0-py39_0.conda ``` Comments Replace \ with the old label.\\ Replace \ with the new label. \\ Replace \ with the package file path to move.