• Games
  • Industry
  • Resources
  • Community
  • Learning
  • Support
Development
Unity Engine
Build 2D and 3D games for any platform
DownloadPlans and pricing
Monetization
In-App Purchase (IAP)
Discover and manage IAP across stores
Mediation
Maximize revenue and optimize monetization
Ad Quality
Protect your app’s user experience
Tapjoy
Build long-term user loyalty
All monetization products
User acquisition
User acquisition
Get discovered and acquire mobile users
Unity Vector AI
Connect players with the right games
Aura on-device advertising
Reach users on-device at peak engagement
All growth products
Use cases
3D collaboration
Build and review 3D projects in real time
Immersive training
Train in immersive environments
Customer experiences
Create interactive 3D experiences
All industry solutions
Industries
Manufacturing
Achieve operational excellence
Retail
Transform in-store experiences into online ones
Automotive
Elevate innovation and in-car experiences
All industries
Technical library
Documentation
Official user manuals and API references
Developer tools
Release versions and issue tracker
Roadmap
Review upcoming features
Glossary
Library of technical terms
Insights
Case studies
Real-world success stories
Best practice guides
Expert tips and tricks
All resources
What's new
Blog
Updates, information, and technical tips
News
News, stories, and press center
Community Hub
Discussions
Discuss, problem-solve, and connect
Events
Global and local events
Community stories
Made with Unity
Showcasing Unity creators
Livestreams
Join devs, creators, and insiders
Unity Awards
Celebrating Unity creators worldwide
For every level
Unity Learn
Master Unity skills for free
Professional training
Level up your team with Unity trainers
New to Unity
Getting started
Kickstart your learning
Unity Essential Pathways
New to Unity? Start your journey
How-to Guides
Actionable tips and best practices
Education
For students
Kickstart your career
For educators
Supercharge your teaching
Education Grant License
Bring Unity’s power to your institution
Certifications
Prove your Unity mastery
Support options
Get help
Helping you succeed with Unity
Success plans
Reach your goals faster with expert support
FAQ
Answers to common questions
Contact us
Connect with our team
Plans and pricing
Language
  • English
  • Deutsch
  • 日本語
  • Français
  • Português
  • 中文
  • Español
  • Русский
  • 한국어
Social
Currency
Purchase
  • Products
  • Unity Ads
  • Subscription
  • Unity Asset Store
  • Resellers
Education
  • Students
  • Educators
  • Institutions
  • Certification
  • Learn
  • Skills Development Program
Download
  • Unity Hub
  • Download Archive
  • Beta Program
Unity Labs
  • Labs
  • Publications
Resources
  • Learn platform
  • Community
  • Documentation
  • Unity QA
  • FAQ
  • Services Status
  • Case Studies
  • Made with Unity
Unity
  • Our Company
  • Newsletter
  • Blog
  • Events
  • Careers
  • Help
  • Press
  • Partners
  • Investors
  • Affiliates
  • Security
  • Social Impact
  • Inclusion & Diversity
  • Contact us
Copyright © 2025 Unity Technologies
  • Legal
  • Privacy Policy
  • Cookies
  • Do Not Sell or Share My Personal Information

"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.

Hero background image
Getting started

Unity Version Control

(formerly Unity Plastic SCM) Resolve merge conflicts and work better together with Unity Version Control, intuitive version control and source code management for both artists and programmers – all in one repo.
Start for free
Learn more
Start for free
Learn more
  • Version Control in Unity
  • Version Control everywhere else
  • Helpful resources
Version control for games

What is Unity Version Control?

Unity Version Control is a scalable, engine-agnostic version control and source code management tool for better collaboration across disciplines. With superior speed handling large files and binaries, it combines both centralized and distributed workflows, so both artists and programmers can work the way they need to.

Watch a demo

Using Unity Version Control with Unity Editor

This guide covers how to set up Version Control in Unity with any of the following Editor versions:

  • 2019.4.29f1 or later
  • 2020.3.15f1 or later
  • 2021.1.15f1 or later
  • 2021.2.0b6 or later
  • Any version beyond 2022.1.0a4
  • 1. Connect Version Control to Unity
  • 2. Create a workspace optimized for your workflow
  • 3. Add asset files associated with your project
  • 4. File types set to ignore by default
  • 5. How to invite team members to Unity Version Control
  • 6. The basics of checking in changes and file history
Connect Plastic SCM to Unity

1. Connect Version Control to Unity

To begin, connect your Unity ID to Unity Version Control and then either select or create a new organization.

  • First, open Unity Version Control in Unity by clicking the Unity Version Control icon in the toolbar on the top right. A window will prompt you to complete your setup.
  • Click log in or sign up, and Unity Version Control will connect automatically to your Unity ID.
  • Next, if your Unity ID isn’t already associated with an organization, you will be prompted to create one. If you already belong to an organization, you will be able to select one to join from a dropdown menu.
Creating a workspace

2. Create a workspace optimized for your workflow

  • Next, return to the Unity Version Control window and click Create workspace.
  • Unity Version Control will suggest names for both your repository (shared files and history) and workspace (your local copy). If you wish to use an existing Unity Version Control repository, click the three dots (:) next to the repo name and select a repository from the list.
  • Next, select the type of workspace you prefer. Unity Version Control is a version control system optimized for game development and 3D projects. As such, it supports separate workflows within the same repo. We designed the Plastic workspace (distributed) for programmers and the Gluon workspace (centralized) for artists.
Add asset files associated with your project

3. Add asset files associated with your project

  • Next, Unity Version Control will display the project files from the asset folder in the Pending changes tab. You can choose specific files to include or add all to the repository by selecting the files and clicking Checkin changes.
  • Version Control will automatically perform a check in for appropriate folders and files – such as package files and project settings – when it’s set up from the Unity Editor. You can view these in the Changesets tab.
  • Once your initial asset check in is complete, you’re set up with Version Control for Unity and ready to create.
File types set to ignore by default

4. File types set to ignore by default

Additionally, there is a list that’s saved in the ignore.conf file at the root of the project that describes which files should be ignored by default. You can edit this to either add or exclude files from the ignore list.

How to invite team members to Plastic SCM

5. How to invite team members to Unity Version Control

  • To invite team members to your project, click on the Options menu (gear icon) in the Version Control tab in Unity, then select Invite Members to Workspace.
  • You will be brought to the Unity Version Control cloud dashboard. Here, you can add new users, resend invitations, or set permissions.

Note: You may be prompted to log in with your Unity ID if you are not signed into the Unity Version Control cloud dashboard.

The basics of checking in changes and file history

6. The basics of checking in changes and file history

The Pending changes tab is where you will check in the changes you’ve saved to the project to send to your repository.

The Changesets tab shows you the project history of changes made to the repository and who made each change. Clicking on each listed changeset allows you to see which files were impacted by that changeset.

You can also view the history of each file by right-clicking and selecting View file history,which shows you a list of changes made to the file. You can right-click on an earlier version and select Revert file to this revision.

Unity Version Control everywhere else

Whether you are using Unreal Engine, an unsupported Unity version, or another engine, you can still use Unity Version Control’s full functionality by downloading the full client.

  • 1. Download and select workflow
  • 2. Log in and set up Unity Version Control
  • 3. Select or create an organization
  • 4. Select or create a repository and workspace
  • 5. Add packages and project settings files
  • 6. Add asset files and get ready to start
  • 7. File types set to ignore by default
  • 8. Pushing changes using a separate client
  • 9. View file history and reverting files in client
  • 10. Connecting Unity Version Control to Unreal Engine
Plastic SCM over Gluon

1. Download and select workflow

  • First, start by downloading Unity Version Control from the Plastic SCM website and following the instructions from the installation wizard.
  • Once complete, you will be prompted to launch the type of workflow you prefer. In order to minimize conflicts between artists and programmers as they collaborate, Version Control provides separate GUIs to facilitate two different workflows within the same repo.
  • We designed the Plastic option for programmers and the Gluon interfacefor artists.
  • This choice is not permanent. You can switch between the Gluon and Plastic interfaces using the top-right menu in the client.
Signing into Plastic SCM

2. Log in and set up Unity Version Control

  • Next, you will be asked to sign in or sign up for an account. Even if you will not be using Unity as the game engine for your project, we recommend using a Unity ID.
Plastic SCM Onboarding

3. Select or create an organization

  • You will be taken to the Plastic home screen, as shown above. If you have no organizations associated with the account, you will be asked to create one. Otherwise, you can select an existing organization that you want to work with.
  • If there are existing repositories, a list will be shown on the left. By clicking one, you can browse repository content before grabbing a working copy of it.
Creating a repo in Plastic SCM

4. Select or create a repository and workspace

  • Click (+) to create a new repository, or select one of the repositories and hit the blue download button to create a workspace and sync it with the repository.
  • For the on-disk path, make sure to select the directory that currently contains the files for your project.
Add packages and project settings

5. Add packages and project settings files

  • The Unity Version Control client will now open your project.
  • If you are directed to an existing project in the previous step, you will need to navigate to the Pending changes tab (if using the developer interface, as shown above), select all packages and Project Settings files and folders, then click Checkin to commit them.
Adding assets to source control

6. Add asset files and get ready to start

  • Next, select the asset folders and files you need to add to the repository to begin working, and click Checkin again.
  • If these are set to private, you can navigate back to Workspace Explorer (called Explore workspace in Gluon), find the files, right-click on them, and select Add to source control, then complete the checkin in the Pending changes tab.
  • You are now set up with Unity Version Control and ready to create.

7. File types set to ignore by default

Additionally, there is a list that’s saved in the ‘ignore.conf’ file at the root of the project that describes which files are ignored by default. You can edit this to either add or exclude files on the ignore list.

Pushing changes using Plastic SCM

8. Pushing changes using a separate client

When using the standalone Unity Version Control client outside of the engine, you’ll need to Checkin changes you saved to the project using the client in a separate window.

The Pending changes tab(or Checkin changes in Gluon) is where you will check in changes you’ve made to the project to send to your repository.

File history and file revisions

9. View file history and reverting files in client

The Changesets tab shows you the project history of changes made to the repository and who made each change. Double-clicking on the changeset listed allows you to see which files were impacted by that changeset.

You can also view the history of each file by right-clicking and selecting View file history,which shows you a list of the changes made to the file. You can also right-click on an earlier version and select Revert to this revision.

Connecting Plastic SCM to Unreal Engine

10. Connecting Unity Version Control to Unreal Engine

If you’re using Unity Version Control with Unreal Engine, you can use source control inside the editor without maintaining separate windows for most tasks. You can find more information on the Unreal Engine plug-in at the link below.

Explore more

More helpful resources

Hidden costs

Find your hidden productivity costs

We’ve collected insights from our product and engineering teams on three of the most common version control pitfalls holding studios back from doing what they do best: creating.

Read the e-book
DevOps

Implement a task branch workflow

Learn how to bring a fast and flexible workflow and philosophy to your team. An efficient task branch workflow helps teams achieve speed through a continuous flow of changes.

Learn how
2022 Version Control

Project organization and best practices

Learn the key concepts of version control as well as tips and tricks you can use when setting up your Unity project to help ensure team collaboration is smooth and efficient.

Read more

Did you find this content helpful?

Yes!

Keep it coming

Meh.

Could be better