# EditorBuildSettings

> This class allows you to modify the Editor Build Settings via script.

## Definition

* **Type:** Class
* **Namespace:** [UnityEditor](/engine/6000.7/script-reference/unityeditor.md)
* **Assembly:** UnityEditor.CoreModule
* **Inherits from:** [Object](/engine/6000.7/script-reference/unityengine/object.md)

```csharp
public class EditorBuildSettings : Object
```

## Remarks

EditorBuildSettings is stored in `ProjectSettings/EditorBuildSettings.asset`. Typically this file should be included in source control.

**Scene List**

The `ProjectSettings/EditorBuildSettings.asset` file contains the global scene list, which defines scenes to be included in the Player build. This list can be overridden by the active [BuildProfile](/engine/6000.7/script-reference/unityeditor/build/profile/buildprofile.md).  For more information see [Override settings with build profiles](/engine/6000.7/manual/building-and-publishing/build-settings/build-profiles-override-settings.md).

**Config Objects**

EditorBuildSettings can be used to persist references to configuration objects.

In this context a config object is an asset, typically a [ScriptableObject](/engine/6000.7/script-reference/unityengine/scriptableobject.md), that contains configuration settings. The objects listed in EditorBuildSettings are not automatically included in the build, making them ideal for editor-only settings. These assets could be accessed by custom build scripts, build callbacks, or any other script running in the editor.

API for working with config objects:

* [EditorBuildSettings.AddConfigObject](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/addconfigobject.md)
* [EditorBuildSettings.RemoveConfigObject](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/removeconfigobject.md)
* [EditorBuildSettings.TryGetConfigObject](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/trygetconfigobject.md)
* [EditorBuildSettings.GetConfigObjectNames](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/getconfigobjectnames.md)

**Config Object Example**

Consider a package with a ScriptableObject-derived class for quality settings. You can customize these settings and create multiple assets, with different values for various contexts. Use [EditorBuildSettings.AddConfigObject](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/addconfigobject.md) to track which asset should be considered as the "active" setting, marked by a distinctive name. Then a build callback reads settings for the active quality settings by calling [EditorBuildSettings.TryGetConfigObject](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/trygetconfigobject.md) with the designated name.

Note: A similar feature is available for config objects that need to be included in the Player build, making them accessible to scripts running in the Player.  See [PlayerSettings.SetPreloadedAssets](/engine/6000.7/script-reference/unityeditor/playersettings/setpreloadedassets.md) and [PlayerSettings.GetPreloadedAssets](/engine/6000.7/script-reference/unityeditor/playersettings/getpreloadedassets.md).

Additional Resources: [EditorBuildSettingsScene](/engine/6000.7/script-reference/unityeditor/editorbuildsettingsscene.md), [EditorUserBuildSettings](/engine/6000.7/script-reference/unityeditor/editoruserbuildsettings.md), [BuildPlayerOptions](/engine/6000.7/script-reference/unityeditor/buildplayeroptions.md), [SceneManager](/engine/6000.7/script-reference/unityengine/scenemanagement/scenemanager.md), [IPreprocessBuildWithContext](/engine/6000.7/script-reference/unityeditor/build/ipreprocessbuildwithcontext.md).

## Static Properties

| Property                                                                                        | Description                                                                                             |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| [globalScenes](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/globalscenes.md) | The list of scenes used by all platform profiles and build profiles that do not override global scenes. |
| [scenes](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/scenes.md)             | The list of scenes in the active platform profile or build profile to be included in the build.         |

## Static Methods

| Method                                                                                                          | Description                                                                        |
| --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [AddConfigObject](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/addconfigobject.md)           | Store a reference to a config object by name.                                      |
| [GetConfigObjectNames](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/getconfigobjectnames.md) | Return a string array containing the names of all stored config object references. |
| [RemoveConfigObject](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/removeconfigobject.md)     | Remove a config object reference by name.                                          |
| [TryGetConfigObject](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/trygetconfigobject.md)     | Retrieve a config object reference by name.                                        |

## Static Events

| Member                                                                                                  | Description                                                                                                                                |
| ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| [sceneListChanged](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/scenelistchanged.md) | A delegate called whenever [EditorBuildSettings.scenes](/engine/6000.7/script-reference/unityeditor/editorbuildsettings/scenes.md) is set. |

## Inheritance

**Inherited Members:**

* [Object.GetEntityId()](/engine/6000.7/script-reference/unityengine/object/getentityid.md)
* [Object.GetHashCode()](/engine/6000.7/script-reference/unityengine/object/gethashcode.md)
* [Object.InstantiateAsync\<T>(T)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, Transform, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, ReadOnlySpan\<Vector3>, ReadOnlySpan\<Quaternion>)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform, Vector3, Quaternion, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform, ReadOnlySpan\<Vector3>, ReadOnlySpan\<Quaternion>)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform, ReadOnlySpan\<Vector3>, ReadOnlySpan\<Quaternion>, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, Vector3, Quaternion, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Vector3, Quaternion, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, ReadOnlySpan\<Vector3>, ReadOnlySpan\<Quaternion>, InstantiateParameters, CancellationToken)](/engine/6000.7/script-reference/unityengine/object/instantiateasync.md)
* [Object.Instantiate(Object, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-vector3-quaternion\))
* [Object.Instantiate(Object, Vector3, Quaternion, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-vector3-quaternion-transform\))
* [Object.Instantiate(Object)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object\))
* [Object.Instantiate(Object, Scene)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-scene\))
* [Object.Instantiate\<T>(T, InstantiateParameters)](/engine/6000.7/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Vector3, Quaternion, InstantiateParameters)](/engine/6000.7/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate(Object, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-transform\))
* [Object.Instantiate(Object, Transform, bool)](/engine/6000.7/script-reference/unityengine/object/instantiate.md#instantiate\(object-transform-bool\))
* [Object.Instantiate\<T>(T)](/engine/6000.7/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Vector3, Quaternion)](/engine/6000.7/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Vector3, Quaternion, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Transform)](/engine/6000.7/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Transform, bool)](/engine/6000.7/script-reference/unityengine/object/instantiate.md)
* [Object.Destroy(Object, float)](/engine/6000.7/script-reference/unityengine/object/destroy.md)
* [Object.DestroyImmediate(Object, bool)](/engine/6000.7/script-reference/unityengine/object/destroyimmediate.md)
* [Object.FindObjectsByType(Type)](/engine/6000.7/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytype\(type\))
* [Object.FindObjectsByType(Type, FindObjectsInactive)](/engine/6000.7/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytype\(type-findobjectsinactive\))
* [Object.DontDestroyOnLoad(Object)](/engine/6000.7/script-reference/unityengine/object/dontdestroyonload.md)
* [Object.FindAnyObjectByType\<T>()](/engine/6000.7/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytypet\(\))
* [Object.FindAnyObjectByType\<T>(FindObjectsInactive)](/engine/6000.7/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytypet\(findobjectsinactive\))
* [Object.FindObjectsByType\<T>()](/engine/6000.7/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytypet\(\))
* [Object.FindObjectsByType\<T>(FindObjectsInactive)](/engine/6000.7/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytypet\(findobjectsinactive\))
* [Object.FindAnyObjectByType(Type)](/engine/6000.7/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytype\(type\))
* [Object.FindAnyObjectByType(Type, FindObjectsInactive)](/engine/6000.7/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytype\(type-findobjectsinactive\))
* [Object.ToString()](/engine/6000.7/script-reference/unityengine/object/tostring.md)
* [Object.name](/engine/6000.7/script-reference/unityengine/object/name.md)
* [Object.hideFlags](/engine/6000.7/script-reference/unityengine/object/hideflags.md)

### Operators

| Operator                                                                           | Description                                                             |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [operator ==](/engine/6000.7/script-reference/unityengine/object/op-equality.md)   | Compares two object references to see if they refer to the same object. |
| [bool](/engine/6000.7/script-reference/unityengine/object/op-implicit.md)          | Determines whether the object exists.                                   |
| [operator !=](/engine/6000.7/script-reference/unityengine/object/op-inequality.md) | Compares if two objects refer to a different object.                    |