Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Open Unity Dashboard

Unity Version Control

​
​
Unity Version Control
  • Overview
  • Cloud Repositories organization update
  • Installation
  • Use UVCS with the Unity Editor
  • Unity Version Control plugins
  • Concepts
  • Tutorials
  • On-Prem
  • Gluon
  • CLI and shortcut references
    • Unity Version Control CLI
    • CLI help
    • Pipe commands
    • cm find
      • Syntax
      • Find branches
      • Find changesets
      • Find replication logs
      • Find labels
      • Find attributes
      • Find revisions
      • Find merges
      • Find code reviews
      • Find shelves
    • Windows keyboard shortcuts
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

Find revisions

Find revisions with the cm find command in Unity Version Control CLI.
Read time 2 minutes
Last updated a year ago

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:
cm find revisions "where changeset=16716" --format="{path}"d:\linked_replicated\d:\linked_replicated\01nervad:\linked_replicated\01nerva\srcd:\linked_replicated\01nerva\src\clientd:\linked_replicated\01nerva\src\client\plasticd:\linked_replicated\01nerva\src\client\plastic\libplasticTranslations.es.resxd:\linked_replicated\01nerva\src\client\plastic\libplasticTranslations.resxd:\linked_replicated\01nerva\src\client\plastic\ActionMenuManager.csTotal: 8
You can also use PowerShell or Bash to filter by folder:
  • Powershell:
    cm find revisions "where changeset=16716" --format="{path}" --nototal | where {$_ -match "client\\"}
  • Bash:
    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:
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:
    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:
    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\/`

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Filtering options

    • Output options

    • cm find revisions examples

      • Find revisions made in a specific changeset

      • Find revisions for a branch


Report a problem with this page