Editor project settings reference
Apply global settings for working in the Unity Editor.
Read time 11 minutesLast updated 12 days ago
Use the Editor settings to apply global settings for working in the Unity Editor. To access the Editor settings, go to Edit > then select the Editor category.
Project Settings
?
Unity Remote
Unity Remote is deprecated. For most use cases, Device Simulator package replaces Unity Remote.
Property | Description |
|---|---|
| Device | Choose the device type you want to use for Unity Remote testing. Unity Remote is a downloadable app designed to help with Android, iOS and tvOS development. |
| Compression | Choose the type of image compression to use when transmitting the game screen to the device via Unity Remote. Choose from the following options:
|
| Resolution | Choose the resolution the game runs at on Unity Remote:
|
| Joystick Source | Choose the connection source for the joysticks you're using:
|
Asset Serialization
Property | Description |
|---|---|
| Mode | Choose which format to use for storing serialized Assets. This is set to Force Text by default. Unity uses serialization to load and save assets and AssetBundles to and from your computer’s hard drive. To help with version control merges, Unity can store scene files in a text-based format. If you aren't merging scenes, Unity can store scenes in a more space-efficient binary format, or allow both text and binary scene files to exist at the same time. Choose from the following formats:
|
Scene Handling
Property | Description |
|---|---|
| Force GC on Scene Loads | Force a managed heap garbage collection and unload unused assets after loading each scene in the Editor in single mode or exiting prefab editing mode. In complex projects, this can slow down performance. Disable this if you do not require class finalizers to run at the end of scene loading. Note that regular dynamic GC and unused asset unloading still occur when memory usage is high, but without this option, class finalizers might not run immediately after each scene load. |
Default Behavior Mode
Property | Description |
|---|---|
| Mode | Choose the default 2D or 3D development mode. Unity sets up the certain default behaviors according to the mode you choose to make development easier:
|
Asset Pipeline
Property | Description |
|---|---|
| Remove unused Artifacts on Restart | Enable to remove unused artifact files in the Library folder and remove their entries in the Asset Database. This setting is a form of garbage collection. Use this setting to disable the Asset Database garbage collection, so that previous artifact revisions which are no longer used are still preserved after you restart the Editor. This is useful if you need to debug unexpected import results. To learn more, refer to Import Activity window. |
| Parallel Import | Use multiple processes to import assets simultaneously. By default, Unity imports assets one after another sequentially on the main Editor process. Parallel importing can be faster than the default sequential method of importing. To learn more, refer to Importing assets out of process |
| Desired worker count | Set the number of import worker processes that the import pipeline considers the optimal number to run in parallel. |
| Standby Import Worker Count | Set the minimum number of worker processes to keep, even if they’re idle. If there are more worker processes than this, Unity shuts down import workers that have been idle for some time, to free up system resources. This property allows you to manage how Unity balances system resources when some processes are idle, compared with the time it takes to start up new import worker processes. You might see an improvement in import performance by increasing this value if you are frequently iterating on model, animation or texture work, and are therefore frequently importing batches of models or image files. |
| Idle Import Worker Shutdown Delay | Set the amount of time in seconds to wait before shutting down an idle worker. |
| Exactly Match Referenced Clip Names | Controls how referenced clips are matched with models animated in Legacy mode. When enabled, model names and referenced clip names must exactly match. When disabled, only the start of the model name must match the referenced clip name. |
Accelerator Cache Server (project specific)
Contains project-specific settings for Unity Accelerator. Use the settings in the Preferences window for global configuration.
Setting | Description |
|---|---|
| Mode | Choose whether to use Unity Accelerator. Choose from the following options:
|
| IP Address | Input the Accelerator's IP address and optionally set a port. If you don't specify a port, Unity uses the default port of |
| Check Connection | Select Check Connection to test the connectivity of the Accelerator. |
| Namespace prefix | Set a custom namespace for the server. |
| Import Result Caching | Uses import result caching to cache assets. |
| Download | Enable downloads from the cache server. |
| Upload | Enable uploads from the cache server. |
| TLS/SSL | Enable encryption on the cache server. |
| Content Validation | Select the level of content validation: Disabled, Upload Only, Enabled, Required. |
| Download Batch Size | Set the size of download. |
Prefab Mode
Contains settings related to prefab editing mode.
Property | Description |
|---|---|
| Allow Auto Save | Enable an Auto Save toggle in prefab editing mode. When Allow Auto Save is disabled, any edits you make aren't automatically saved and the toggle doesn't display. For more information, refer to Automatically save edits to the prefab asset. |
| Regular Environment | Assign a scene as an editing environment in prefab editing mode for regular prefabs (those with a regular Transform component). This allows you to edit a prefab against a backdrop of your choosing rather than an empty scene. For more information, refer to Editing prefab assets. |
| UI Environment | Assign a scene as an editing environment in prefab editing mode for UI prefabs (those with a Rect Transform component). This allows you to edit a prefab against a backdrop of your choosing rather than an empty scene. For more information, refer to Editing prefab assets. |
Graphics
Property | Description |
|---|---|
| Use legacy Light Probe sample counts | Use fixed Light Probe sample counts for baking with the light baker. The sample counts are: 64 direct samples, 2048 indirect samples, and 2048 environment samples. Note: Environment samples only apply to the Progressive Light Baker. |
Sprite Atlas
Property | Description |
|---|---|
| Mode | Choose a mode to configure the Sprite Atlas tool:
|
C# Project Generation
Property | Description |
|---|---|
| Additional extensions to include | Include a list of additional file types to add to the C# project. Separate each file type with a semicolon. By default, this field contains |
| Root namespace | Fill in the namespace to use for the C# project |
Texture Compressors
Property | Description |
|---|---|
| BC7 Compressor | Select the compressor to use for BC7 format texture compression. |
| ETC Compressor | Select the compressors to use for different compression qualities of ETC Textures. The compression tools available are etcpak, ETCPACK and Etc2Comp. These are all third-party compressor libraries. Choose from the following:
|
| Fast | Define the compression quality tool to use for Fast compression. This property is modifiable only when ETC Compressor is set to Custom. |
| Normal | Define the compression quality tool to use for Normal compression. This property is modifiable only when ETC Compressor is set to Custom. |
| Best | Define the compression quality tool to use for Best compression. This property is modifiable only when ETC Compressor is set to Custom. |
Line Endings For New Scripts
Property | Description |
|---|---|
| Mode | Choose the file line endings to apply to new scripts created within the Editor. Note that configuring these settings does not convert existing scripts. Choose from the following:
|
Texture Streaming Settings
If you enable Mipmap Streaming in the Editor for one mode but not the other, entering and exiting Play mode takes slightly longer. Enabling Mipmap Streaming for both modes prevents Unity from unloading and reloading mipmap data, and increases the speed of entering and exiting Play Mode.
Property | Description |
|---|---|
| Enable Mipmap Streaming in Play Mode | Enable Mipmap Streaming in Play mode. The Texture Mipmap Streaming setting in the Quality project settings must also be enabled. Play mode might take longer to open and close if you enable this setting and disable Enable Mipmap Streaming in Edit Mode. |
| Enable Mipmap Streaming in Edit Mode | Enable Mipmap Streaming in Edit Mode. The Texture Mipmap Streaming setting in the Quality project settings must also be enabled. Play mode might take longer to open and close if you enable this setting but disable Enable Mipmap Streaming in Play Mode. |
| Load texture data on demand | Load CPU-side texture data from disk asynchronously on demand to avoid some stalls and reduce CPU memory usage. If you enable mipmap streaming, this setting requires more processing time on the CPU, and might cause textures to temporarily appear at a lower resolution while Unity loads a higher resolution mipmap level from disk. |
Shader Compilation
Property | Description |
|---|---|
| Asynchronous Shader Compilation | Enable this checkbox to make Unity compile shaders in the background. While compiling, the Unity engine uses a placeholder Shader to render geometry in the Editor. When Shader compilation has finished, the engine swaps your Shader Variant back in. This means the Editor runs seamlessly, without having to wait for the Unity engine to compile every single Shader variant before rendering. For more information, refer to Asynchronous Shader compilation. |
Enter Play Mode Settings
Property | Description |
|---|---|
| When entering play mode | Select code and scene reload behavior on entering Play mode. Domain reloading is when the Editor reloads scripts to reset static state on entering Play mode, and is off by default. Scene reloading is when the Editor destroys all scene GameObjects and reloads the scene from disk on entering Play mode, and is on by default. To enter Play mode faster, you can disable scene or domain reloads. For more information, refer to Code and Scene reload on entering Play mode. Choose from the following options:
|
Numbering Scheme
Property | Description |
|---|---|
| Game Object Naming | Naming scheme for duplicated GameObjects. Duplicated or instantiated GameObjects are named by appending successive numbers to the original object name. |
| Game Object Digits | Sets the amount of digits to use for duplicated GameObject numbers. |
| Space Before Number in Asset Names | Controls whether to insert a space before a number in duplicated Asset names. |
Hierarchy
Property | Description |
|---|---|
| Use Legacy Hierarchy | Use the legacy Hierarchy window in this project. This setting is disabled by default. When you change this setting, any open Hierarchy windows update immediately. |
Inspector
Property | Description |
|---|---|
| Use IMGUI Default Inspector | Revert to using IMGUI to generate Default Inspectors where no custom Inspector or Editor is defined. |
Build Profiles
Property | Description |
|---|---|
| Hide Classic Platforms | Hide the classic platforms list in the Build Profiles window. For new projects, this setting is enabled by default. |