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
      • acl
      • activateuser
      • add
      • admin
      • annotate
      • api
      • applylocal
      • archive
      • attribute
      • autocomplete
      • branch
      • changelist
      • changerevisiontype
      • changeset
      • changeuserpassword
      • checkconnection
      • checkin
      • checkout
      • checkselectorsyntax
      • clone
      • codereview
      • configure
      • crypt
      • deactivateuser
      • diff
      • diffmetrics
      • fastexport
      • fastimport
      • fileinfo
      • find
      • getconfig
      • getfile
      • getrevision
      • getstatus
      • gettaskbranches
      • getworkspacefrompath
      • getworkspaceinfo
      • help
      • history
      • iostats
      • issuetracker
      • label
      • licenseinfo
      • linktask
      • list
      • listusers
      • location
      • lock
      • log
      • merge
      • move
      • objectspec
      • partial
      • patch
      • profile
      • pull
      • purge
      • push
      • query
      • remove
      • repository
      • revert
      • setowner
      • shelveset
      • show-find-objects
      • showacl
      • showcommands
      • showowner
      • showpermissions
      • support
      • switch
      • sync
      • trigger
      • tube
      • undelete
      • undo
      • undochange
      • undocheckout
      • undocheckoutunchanged
      • update
      • version
      • whoami
      • workspace
      • workspacestatus
      • xlink
    • CLI help
    • Pipe commands
    • cm find
    • Windows keyboard shortcuts
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

HISTORY

View history with the Unity Version Control CLI.
Read time 2 minutes
Last updated 10 months ago

Description

Displays the history of a file or directory.

Usage

cm history | hist <item_path>[ ...] [--long | --format=<str_format>] [--symlink] [--xml[=<output_file>]] [--encoding=<name>] [--moveddeleted]

Options

Option / Argument

Description

--long
Shows additional information.
--format
Retrieves the output message in a specific format. See Remarks for more info. This option cannnot be combined with 
--xml
.
--symlink
Applies the history operation to the symlink and not to the target.
--xml
Prints the output in XML format to the standard output. It is possible to specify an output file. This option cannot be combined with 
--format
.
--encoding
Used with the 
--xml
option, specifies the encoding to use in the XML output, i.e.: utf-8. See the MSDN documentation at http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx to get the table of supported encodings and its format, (at the end of the page, in the "Name" column).
--moveddeleted
Include move and remove operations in the history.
--limit
Displays the N most recent revisions for the specified items, sorted by date and changeset id. If a negative number is supplied, it will return an empty list. If a number higher than the number of revisions is supplied, it will return all the available revisions regarding that item.
item_path
Item's path. Use a whitespace to separate paths. Use double quotes (
" "
) to specify paths containing spaces. Paths can be server path revisions too. (Use 
cm help objectspec
to learn more about specs.)

Help

Remarks

This command shows a list of revisions for a given item, and label, branch, and comment info for each revision.

Output format parameters (
--format option
)

This command accepts a format string to show the output. The output parameters of this command are the following:

Option / Argument

Description

{0} | {date}
Date.
{1} | {changesetid}
Changeset number.
{2} | {branch}
Branch.
{4} | {comment}
Comment.
{5} | {owner}
Owner.
{6} | {id}
Revision id.
{7} | {repository}
Repository.
{8} | {server}
Server.
{9} | {repspec}
Repository spec.
{10} | {datastatus}
Availability of the revision data.
{11} | {path}
Path or spec passed as 
<item_path>
.
{12} | {itemid}
Item Id.
{13} | {size}
Size.
{14} | {hash}
Hash code.
{tab}
Inserts a tab space.
{newline}
Inserts a new line.

Examples

cm history file1.txt "file 2.txt"
cm hist c:\workspace --long
(Displays all information.)
cm history link --symlink
(Applies the history operation to the symlink file and not to the target.)
cm history serverpath:/src/foo/bar.c#br:/main/task001@myserver
(Retrieves the revision history from a server path in a given branch.)
cm history bar.c, foo.c --long --limit=2
(Retrieves the 2 last revisions for the bar.c and foo.c items.)
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

    • Description

      • Usage

      • Options

    • Help

      • Remarks

        • Output format parameters (--format option)

      • Examples

Report a problem with this page