# Find revisions

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

Find and filter revisions.

## Filtering options

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

* `archived`
* `attribute`
* `attrvalue`
* `branch`
* `changeset`
* `date`
* `guid`
* `id`
* `item`
* `itemid`
* `label`
* `marker`
* `owner`
* `parent`
* `repllogid`
* `replsrcdate`
* `replsrcid`
* `replsrcrepository`
* `replsrcserver`
* `returnparent`
* `shelve`
* `size`
* `type`
* `workspacecheckoutid`

## Output options

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

* `branch`
* `changeset`
* `date`
* `id`
* `item`
* `itemid`
* `owner`
* `parent`
* `size`
* `type`

## `cm find revisions` examples

### Find revisions made in a specific changeset

You can use a custom format, for example if you only want to find the file and folder paths of the revisions in a specific changeset:

```text
cm find revisions "where changeset=16716" --format="{path}"
d:\linked_replicated\
d:\linked_replicated\01nerva
d:\linked_replicated\01nerva\src
d:\linked_replicated\01nerva\src\client
d:\linked_replicated\01nerva\src\client\plastic
d:\linked_replicated\01nerva\src\client\plastic\libplasticTranslations.es.resx
d:\linked_replicated\01nerva\src\client\plastic\libplasticTranslations.resx
d:\linked_replicated\01nerva\src\client\plastic\ActionMenuManager.cs

Total: 8
```

You can also use PowerShell or Bash to filter by folder:

* Powershell:
  ```text
  cm find revisions "where changeset=16716" --format="{path}" --nototal | where {$_ -match "client\\"}
  ```

* Bash:
  ```text
  bcm find revisions "where changeset=15430" --format="{path}" --nototal | grep client\/
  ```

### Find revisions for a branch

The following example returns all the revisions for a specific changeset within a specified timespan:

```text
cm find revisions "where branch = 'main/Fix-4.1/scm12814' and date <= '2013/05/30' and date > '2013/05/28'" --format="{date} - {path}"
```

You can also use PowerShell or Bash to filter the information:

* Powershell:
  ```text
  cm find revisions "where branch = 'main/Fix-4.1/scm12814' and date <= '2013/05/30' and date > '2013/05/28'" --format="{date} - {path}" | where {$_ -match "view\\"}
  ```
* Bash:
  ```text
  cm find revisions "where branch = 'main/Fix-4.1/scm12814' and date <= '2013/05/30' and date > '2013/05/28'" --format="{date} - {path}" | grep view\/`
  ```