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
        • partial add
        • partial checkin
        • partial checkout
        • partial configure
        • partial move
        • partial remove
        • partial shelveset
        • partial switch
        • partial undo
        • partial undocheckout
        • partial update
      • 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)

PARTIAL CHECKOUT

Perform checkouts in a partial replica with the Unity Version Control CLI.
Read time 1 minute
Last updated 10 months ago

Description

Marks files as ready to modify.

Usage

cm partial checkout | co [<item_path>[ ...]] [--resultformat=<str_format>] [--silent] [--ignorefailed]

Options

Option / Argument

Description

item_pathItems to checkout. Use double quotes (" ") to specify paths containing spaces. Use a whitespace to separate paths. Use . to apply checkout to current directory.
--resultformatRetrieves the output result message in a specific format.
--silentDoes not show any output.
--ignorefailedIf an item cannot be locked (the exclusive checkout cannot be performed), the checkout operation will continue without it.

Help

Remarks

To checkout an item

  • The item must be under source code control.
  • The item must be checked in.
If locks are configured on the server (lock.conf exists), then each time a checkout on a path happens, UVCS checks if it meets any of the rules and if so, the path will be in exclusive checkout (locked) so that none can simultaneously checkout. You can get all the locks in the server by using
cm lock list
. Refer to Smart locks for more information.

Examples

cm partial checkout pic1.png pic2.png
(Checkouts 'pic1.png' and 'pic2.png' files.)
cm partial co *.png
(Checkouts all png files.)
cm partial checkout .
(Checkouts current directory.)
cm partial checkout -R c:\workspace\src
(Recursively checkouts 'src' folder.)

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

        • To checkout an item

      • Examples


Report a problem with this page