Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


Preset Manager project settings reference

Manage custom Presets that you create to specify default properties for when you add a component to a GameObject or a new asset to your project.
Read time 6 minutesLast updated 21 days ago

The Preset Manager is a window in Project Settings (menu: Edit >
Project Settings

?

> Preset Manager) that allows you to manage custom Presets you create to specify default properties when you add a component to a GameObject or a new Asset to your project. The default Presets you define override Unity's default settings.
Note
You cannot set the default properties for Project settings, Preferences settings, or native Assets such as Materials, Animations, or SpriteSheets.
In addition to using default Presets when creating new components and importing Assets, Unity applies default Presets when you use the Reset command in the Component Context Menu in the Inspector window.

Preset Manager reference

Preset Manager window

Property

Description

FilterUse the Filter field to define which components or importers the Preset is applied to.
PresetUse the Preset field to set the Preset you want to use. By default, a Preset applies to all components or asset importers of that Preset type once you create it. If you want to only apply it to specific components or asset types, use the Filter field to define when to apply the Preset.
Add Default PresetSelect this button to choose the Importer, Component, or ScriptableObject to add a Preset to. If you choose Importer or Component, select the type of asset importer or component you want to create a Preset for.

Assigning a Preset for default settings

To specify a Preset to use for default settings in the Preset Manager:
  1. If you don’t already have a Preset in your project to use for default settings, create one.
  2. Open the Preset Manager by choosing Edit > Project Settings, and selecting the Preset Manager.
  3. Select Add Default Preset and select a default type.
    The Preset type you choose appears in the Preset Manager list.

    Select a Preset type

  4. In the Preset field, click the Preset selector (circle icon).
  5. From the Select Preset window, choose a Preset for this Preset type.
    Alternatively, you can also drag and drop a Preset from the Project window into the Preset field.
  6. If you want to add another Preset field to the list, click the Add (+) tab.

    Choose a Preset

Note
If you set a default Preset for Transform components, Unity does not use the Position values when you create a new GameObject. Instead, it sets the default Position values to the center of the Scene view. To set the Position values to those of the default Preset, select the Transform component’s More items button (⋮) and select Reset.

Assigning Presets via the Inspector window

You can also add and remove Presets to use for default settings via the
Inspector

?

window.
To add a default Preset:
  1. Select a Preset in the Project window.
  2. In the Inspector window, click Add to default.
    Unity adds your default Preset to the Preset Manager.
  3. Open the Preset Manager to add filters to the Preset or reorder your Preset list.

    Add to default (red) in the Inspector window

To remove a default Preset:
  1. Select a Preset in the Project window.
  2. In the Inspector window, click Remove from.

Adding filters

By default, a Preset applies to all components or asset importers of that Preset type once it is created. If you want to only apply it to specific components or asset types, you can use the Filter field to define when to apply the Preset.
Filters allow you to create multiple Presets for a given type, and apply them to specific components or importers based on whether those components and importers meet the filter criteria. You can filter by file names, folders, and file extensions.
You can also apply partial Presets that affect only properties you specify in your components or assets.
Note
Default Presets in a Preset Type are applied in order from top to bottom. This means that filters at the bottom of the list can override previous filters if not logically ordered.
  1. Open the Preset Manager by choosing Edit > Project Settings, then selecting the Preset Manager category.
  2. Find the default Preset you want to filter, and enter the search string in the Filter field.
Presets can use glob search, which is a way to use symbols in your filters to allow for more inclusive import filters. See the table below for a list of symbols you can use. A glob search filter is case-sensitive.
To create a glob search filter, the syntax is
glob:"yoursearchpatternhere"
. Your filter field must begin
glob:
, and the search term must be in quotation mark characters. For example,
glob:"example-folder/*.fbx"
filters for any .fbx file in a folder called
example-folder
.
Supported symbols:

Symbol

Description

Example

*Match 0 or more characters in a single path portion (a single path portion is defined as any suite of characters excluding / )
glob:"foldername/*.fbx"

searches for any .fbx file located in a folder named
foldername
.
?Match 1 character
glob:"foldername/filename-?.fbx"

searches for any .fbx file located in a folder named
foldername
that has the name
filename-
followed by one single character.
For example, this includes
filename-1.fbx
,
filename-2.fbx
, but not
filename-01.fbx
.
[...]Match 1 character in the specified range, similar to a RegExp range. If the first character of the range is ! or ^ then it matches any character not in the range.
glob:"foldername/file-[0-9]1.fbx"

Matches .fbx files located in the folder named
foldername
where the filename begins with
file-
and ends with a two-digit number ending in
1
.
This example matches
file-01.fbx
,
file-11.fbx
, and
file-21.fbx
, but not
file-2.fbx
, or
file-22.fbx
.
(pattern-1|pattern-2|pattern-3)Place a search inside parentheses and separate patterns by a vertical pipe to match one or more search patterns. The vertical pipe character denotes
or
.
glob:"(foldername/filename-?.fbx|foldername/file-?.fbx)"

Matches .fbx files located in the folder named
foldername
where the file name is either
filename-
or
file-
followed by a single character.
This example matches
filename-1.fbx
,
file-1.fbx
, and
file-2.fbx
, but not
filename-22.fbx
, or
file-22.fbx
.
**Match zero or more folders and subfolders.
glob:"foldername/**.fbx"

Matches any .fbx file located in the folder named
foldername
and its subfolders.
Note
Unity does not apply default asset importer presets when you select Reimport on an existing asset. To apply presets to assets that have already been imported, use the Reset command in the Component Context Menu in the Inspector window.

Editing the list of default Presets

This section describes how to toggle, move and remove Presets in the Preset Manager’s default Preset list for each Preset type.
  • Reorder a Preset list: Select the handle (=) of the default Preset that you want to move, and drag it to the new position.
  • Remove a Preset: Select the handle (=) of the default Preset that you want to remove, then click the Remove (-) button to remove the selected Preset.
  • Remove a Preset type: Remove all Presets assigned to that default Preset type.

Disabling and enabling default Presets

You can temporarily disable/enable a default Preset without losing filter settings.
  1. Open the Preset Manager by choosing Edit > Project Settings, and then selecting the Preset Manager category.
  2. Clear the check box to the left of the default Preset to disable the Preset. Select the check box to enable.

    Disable or enable a Preset