Editing scene templates
Modify scene template properties and configure which assets to clone or reference when creating new scenes.
Read time 3 minutesLast updated 21 days ago
To edit a scene template, select it in the Project window, then open it in an Inspector window.
Note
When you first create an empty scene template, you must edit its properties to associate it with a scene before you can use it. Templates that you create from the active scene, or an existing scene asset, have some properties set by default.
The Inspector window displays the properties of a scene template asset.
The scene template Inspector has the following sections:
- Details: Specifies which scene the template uses, and contains the template description that appears in the New Scene dialog.
- Thumbnail: Provides options for creating a preview image for the template.
- Scene Template Pipeline: Specifies an optional custom script to run when Unity creates a new scene from the template.
- Dependencies: Lists the template scene's dependencies, and specifies whether Unity clones them when it creates a new scene from the template.
Details
Use the Details section to specify which scene to use for a template, and control how the template appears in the New Scene dialog.
The Details section of the scene template Inspector window.
Property: | Description: |
|---|---|
| Template Scene | Specifies the scene to use as a template. This can be any scene in the Project. |
| Title | The template name. The name you enter here appears in the New Scene dialog. |
| Description | The template description. The description you enter here appears in the New Scene dialog. |
| Pin in New Scene Dialog | Controls whether this template is pinned in the New Scene dialog. Pinned templates always appear at the top of the Scene Templates in Project list. |
Thumbnail
The Thumbnail section contains options for creating a preview image for the template.
The Thumbnail section of the scene template Inspector window.
Property: | Description: |
|---|---|
| Badge | Specifies a Texture asset to use as a badge thumbnail for this template. You can use any Texture asset in the project. Badge thumbnails are commonly used as a quick way to identify what type of scene this template relates to, for example: 2D or 3D. |
| Preview | Specifies a texture to use as a preview thumbnail for this template. You can use any Texture asset in the project. The preview image appears in the New Scene dialog when selecting a scene template. |
| Snapshot | Provides options for capturing a thumbnail image for this template. Select a View to take the snapshot from. The following options are available:
|
Scene Template Pipeline
Use these properties to add a Scene Template Pipeline script to this template.
The Inspector window displays the Scene Template Pipeline section of the properties for a scene template asset.
A Scene Template Pipeline script lets you execute custom code when you create a new scene from the template. See Customizing new scene creation.
Dependencies
This section lists all of the template scene's Dependencies. You can specify whether or not to Clone each dependency when you create a new scene from the template.
To search for a dependency by name, enter text in the search bar.
To sort the Dependencies list:
- Click the Dependencies heading to sort by the name of the dependency in alphabetical order.
- Click the Type heading to sort by the dependency Type.
- Click the Clone heading to sort by dependencies that are cloned and not cloned.
The Inspector window displays the Dependencies section of the properties for a scene template asset.
For each dependency in the list, toggle the Clone option on to clone the dependency, or off to reference the dependency. When you clone a dependency, you create a copy. When you reference a dependency, all changes made to the original will affect the dependency.
When you create a new scene from the template, Unity checks whether the template scene has cloneable dependencies. If it does, Unity creates a folder with the same name as the new scene, and puts any cloned dependencies in that folder.
For more information about cloned and referenced dependencies, see Templates and scene dependencies.
To specify which types of asset Unity clones by default, edit the scene template Project settings.