Documentation

Support

Unity Version Control

Ignore files

Configure files to ignore in Unity Version Control.
Read time 1 minuteLast updated 21 days ago

Some files never need to be edited or checked in, so you can add them to the ignored list so that Unity Version Control (UVCS) doesn’t track them.

Configure the ignored files list

You can configure your ignored files in the Unity DevOps Version Control application:
  1. In the Workspace Explorer tab, right-click the item.
  2. Select Add to ignored list and select the specific path or item.
  3. Select Apply rules to all workspaces to add the item to the ignored list in every workspace.
  4. Select OK.

Share ignore configuration

There are multiple ways you can share the
ignore.conf
file with your coworkers:
  • Add the
    ignore.conf
    file to the repository and check it in so that your coworkers recieve it when they next update their workspace.
  • Add the
    ignore.conf
    file to the
    plastic-global-config
    repository to deploy the file on every client.

Recommended ignore configuration for Unity projects

Be aware of certain files and directories in Unity Editor projects that you might or might not want to ignore.

Directories to ignore

Unity recommends that you ignore all directories and files that automatically regenerate in you Unity project. For example, the
Library
and
Temp
directories are the most populated paths in your Unity project. They can hold thousands of files and weigh several GBs, and if you delete them, Unity creates them again.

Directories not to ignore

Don't add the following directories to your ignore file:
  • Assets
    directory
  • Project settings
    directory
Without these directories, your coworkers can't open the Unity project.

Example Unity ignore file

The following is an example of an ignore file that works with a Unity project:
#Common directoriesLibrarylibraryTemptempObjobjBuildbuildBuildsbuildsUserSettingsusersettingsMemoryCapturesmemorycapturesLogslogs**/Assets/AssetStoreTools**/assets/assetstoretools**/Assets/AddressableAssetsData/*/*.bin***/assets/addressableassetsdata/*/*.bin***/Assets/StreamingAssets/aa.meta**/assets/streamingassets/*/aa/*.collabignore# Builds*.apk*.unitypackage#Plastic SCM related/ignore.conf*.private*.private.meta^*.private.[0-9]+$^*.private.[0-9]+.meta$# Gradle cache directory.gradle# Autogenerated project files/Assets/Plugins/Editor/JetBrains*/assets/Plugins/Editor/JetBrains*.vsExportedObj.consulo*.csproj*.unityproj*.sln*.suo*.tmp*.user*.userprefs*.pidb*.booproj*.svd*.pdb*.mdb*.opendb*.VC.db# Unity3D generated meta files*.pidb.meta*.pdb.meta*.mdb.meta# Unity3D Generated File On Crash Reportssysinfo.txt# Crashlytics generated filecrashlytics-build.properties#Mac.DS_Store*Thumbs.dbDesktop.ini