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)

Checkouts

Learn how to check out files and manage changes in Unity Version Control workspaces.
Read time 1 minute
Last updated 10 months ago

Unity DevOps Version Control (UVCS) automatically detects any changes to a file within your current workspace and adds them to your pending changes. To notify that you want to make changes to specific files, check out these files. You might want to check out a file for various reasons:
  • If you work with locks, you might need to check out files before you edit them. For more information, refer to [Smart locks(../pages/smart-locks.mdx).
  • If you work with a large codebase of, for example, more than 500,000 files, checkouts can speed up your operations. Instead of searching through your entire workspace for changes, UVCS can list the files in the checkout list without accessing the disk.
To then merge your changes, you can check them in as normal. For more information, refer to Check in changes.

Types of checkout

To check out a file in 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.
Checkouts
Learn how to check out files and manage changes in Unity Version Control workspaces.
Shelve changes
Shelve changes to files in Unity Version Control.
Undo changes
Undo local changes in your repository.

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
    • Types of checkout


Report a problem with this page