# Find labels

> Find labels with the cm find command in Unity Version Control CLI.

Find and filter labels.

## Filtering options

The following list displays the different filtering options (`where`) that are available to use with the `cm find label` command:

* `attribute`
* `attrvalue`
* `branch`
* `branchid`
* `changeset`
* `comment`
* `date`
* `guid`
* `id`
* `name`
* `owner`
* `repllogid`
* `replsrcdate`
* `replsrcid`
* `replsrcrepository`
* `replsrcserver`

> **Note:**
>
> The condition `date` corresponds to the **Creation date** column in the **Labels** view of the UVCS desktop application.

## Output options

The following list displays the different output options (`--format`) available to use with the `cm find label` command:

* `branch`
* `branchid`
* `changeset`
* `comment`
* `date`
* `id`
* `name`
* `owner`

## `cm find label` examples

### Find all labels in a specific repository

```text
cm find label --format="{name} {owner} {branch} {branchid}" --nototal on repository 'codice'
BL234   dpenalba    /main   3
BL235   lrodriguez    /main   3
BL236   jgonzalez    /main/task001   4
BL237   jgonzalez    /main   3
BL238   lrodriguez    /main/task002   5
BL239   lrodriguez    /main   3
```

### Find all labels created in a specific branch in a repository

```text
cm find label "where branch = '/main'" --format="{name} {owner}" --nototal on repository 'codice'
BL234   dpenalba
BL235   lrodriguez
BL237   jgonzalez
BL239   lrodriguez
```

### Find a branch with a specific label

```text
cm find label "where name = 'BL237' on repository 'codice'" --nototal
191871  17/11/2011 16:38:06   BL237   10503   /main   lrodriguez    codice
```

### Find changesets created between two labels

```text
cm find label "where name = 'BL237' or name='BL235' on repository 'codice'" --nototal 
191869    11/11/2011 14:20:02   BL235   1750    /main   lrodriguez    codice
191871    17/11/2011 16:38:06   BL237   10503   /main   lrodriguez    codice
```