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
    • Migrate from Git
    • Migrate from Perforce
    • Version Control settings
    • Configure the client
    • Version Control workflow
      • Set up a workspace
      • Create a repository
      • Use a nodata replica
      • Create a branch
      • Modify files
      • View file history
      • Code reviews
      • Code reviews (GUI)
      • Merge changes
        • Merge branches
        • Navigate the Mergetool window
        • Resolve merge conflicts
        • Checkouts
          • Check out a file
          • Check in changes
        • Shelve changes
        • Undo changes
    • Version Control tools
  • On-Prem
  • Gluon
  • CLI and shortcut references
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

Check out a file

Check out files to edit in Unity Version Control.
Read time 1 minute
Last updated 10 months ago

Check out a file in the GUI

To check out a file on the Workspace Explorer tab, right-click the file and select one of the following types of checkout:

Option

Description

CheckoutIf the file path matches the configured lock rules, the checkout operation locks the file. If the file path doesn’t have the lock rules, then the checkout is a local operation that doesn’t lock the file.
Lock and checkoutLock and checkout adds the file path to your configured lock rules so that the file locks regardless of the original lock rules.

Check out a file in the CLI

Read more about checkouts and why you might want to use them.
The 
cm ci
command checks in any checked out files in your workspace. To check in all changes, add the 
--all
modifier.
Note
UVCS considers any files that you move with the 
cm mv
 command checked out.
  1. Run the 
    cm co
     command to check out a file before you edit it.
>cm co q3radiant\Bmp.cppThe selected items are about to be checked out. Please wait ...Item q3radiant\Bmp.cpp was correctly checked out
  1. Run the 
    cm ci
     command to check in your files.
>cm ci -c "changed bmp and moved aselib"The selected items are about to be checked in. Please wait ...Assembling checkin dataValidating checkin dataUploading file dataUploaded 0 bytes of 9.26 KB (0%)Confirming checkin operationModified c:\Users\pablo\wkspaces\quake_path\q3radiant\Bmp.cppCreated changeset cs:577@br:/main/fix-1342@quake@localhost:6060 (mount:'/')

Additional resources

  • Checkouts
  • Smart Locks
  • Use Smart Locks
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

    • Check out a file in the GUI

    • Check out a file in the CLI

    • Additional resources

Report a problem with this page