Version: 2021.2
Scene Templates
Editing scene templates

Creating scene templates

You can create a new sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary
template in one of the following ways:

After you create a template, you can edit its properties or create new scenes from it.

Tip:
Before you create a template from a scene, create a folder with the name as the scene, and put any assets you want to clone in it. When you create the template, Unity automatically enables the Clone property for those assets. For details, see Editing scene templates.

Creating an empty scene template

You can create empty scene templates and configure them later. An empty template does not appear in the New Scene dialog until you edit its properties to associate a scene asset to it.

To create an empty scene template in the current project folder:

  • From the menu, select Assets > Create > Scene Template.

To create an empty scene template in a specific project folder:

  1. Do one of the following:

  2. In the Project windowA window that shows the contents of your Assets folder (Project tab) More info
    See in Glossary
    , right-click the folder to open the context menu.

  3. Open the folder in the Project window, and right-click the asset pane to open the context menu.

  4. Select Create > Scene Template.

Creating a template from an existing scene asset

You can turn any existing scene into a scene template. After you create a template from an existing scene, you might want to edit its properties to specify which of its dependenciesIn the context of the Package Manager, a dependency is a specific package version (expressed in the form package_name@package_version) that a project or another package requires in order to work. Projects and packages use the dependencies attribute in their manifests to define the set of packages they require. For projects, these are considered direct dependencies; for packages, these are indirect, or transitive, dependencies. More info
See in Glossary
Unity clones when you create a new scene from it.

To create a template from an existing scene asset, open the Project window, and do one of the following:

  • Right-click a scene asset to open the context menu. Then select Create > Scene Template From Scene.
  • Select the scene asset, and from the main menu, select Assets > Create > Scene Template From Scene.

Creating a template from the current scene

To create a scene template from the current scene, from the menu, select File > Save As Scene Template.

If you have unsaved changes, Unity prompts you to save the scene before it saves the template.

After you create a template from the current scene, you might want to edit its properties to specify which of its dependencies Unity clones when you create a new scene from it.

Creating templates from C# scripts

You can create scene templates from your C# scriptsA piece of code that allows you to create your own Components, trigger game events, modify Component properties over time and respond to user input in any way you like. More info
See in Glossary
.

To create an empty scene template, use the CreateSceneTemplate method.

SceneTemplate.CreateSceneTemplate(string sceneTemplatePath)

To create a template from an existing scene, use the CreateTemplateFromScene method. Unity automatically associates the scene with the template, and extracts the scene’s dependencies.

SceneTemplate.CreateTemplateFromScene(SceneAsset sourceSceneAsset, string sceneTemplatePath);

Scene Templates
Editing scene templates