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
        • workspace create
        • workspace delete
        • workspace list
        • workspace move
        • workspace rename
      • workspacestatus
      • xlink
    • CLI help
    • Pipe commands
    • cm find
    • Windows keyboard shortcuts
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

WORKSPACE LIST

List workspaces with the Unity Version Control CLI.
Read time 1 minute
Last updated 10 months ago

Description

Lists workspaces.

Usage

cm workspace | wk [list | ls] [--format=<str_format>]

Options

Option / Argument

Description

--formatRetrieves the output message in a specific format. See Remarks for more info.

Help

Remarks

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}
|
{wkname}
Workspace name.
{1}
|
{machine}
Client machine name.
{2}
|
{path}
Workspace path.
{3}
|
{wkid}
Workspace unique identifier.
{4}
|
{wkspec}
Workspace specification using the format: 'wkname@machine'.
{tab}
Inserts a tab space.
{newline}
Inserts a new line.

Examples

cm wk
(Lists all workspaces.)
cm workspace list --format={0}#{3,40}
cm workspace list --format={wkname}#{wkid,40}
(Lists all workspaces and shows the workspace name, a # symbol and the workspace GUID field in 40 spaces, aligned to left.)
cm wk --format="Workspace {0} in path {2}"
cm wk --format="Workspace {wkname} in path {path}"
(Lists all workspaces and shows result as formatted strings.)

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