> For the complete documentation index, see [llms.txt](https://sonity.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sonity.gitbook.io/docs/soundpreset.md).

# SoundPreset

Use SoundPresets to apply default values to your sounds

<div align="left"><img src="https://3478075546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECYQ2OSoWTLdq4EUgnCW%2Fuploads%2FzwCzdq51eyzVUTKbpGQK%2FSoundPreset.png?alt=media&amp;token=cc6c9828-ce52-4bc5-81f7-8bc11c961997" alt="" width="514"></div>

Use [SoundPreset](/docs/soundpreset.md) to apply settings to [SoundContainers](/docs/soundcontainer.md) and [SoundEvents](/docs/soundevent.md) automatically by matching the names of your assets.\
Its matched and applied when you [Create Assets From Selection](/docs/sonity/create-assets-from-selection.md) or manually from the [SoundContainer Presets](/docs/soundcontainer.md#presets) and the [SoundEvent Presets](/docs/soundevent.md#presets) toolbars.\
Example use: Name UI sounds to “UI\_” and use Is Prefix “UI\_” to automatically assign settings like disabling distance and setting Spatial Blend to 0.\
The settings are applied ordering from the one highest up and going downwards and can match an asset multiple times overwriting previous values.\
You can have multiple [SoundPreset](/docs/soundpreset.md) objects.

**Notes**\
At the top of the [SoundPreset](/docs/soundpreset.md) there is a text field which you can fill with notes.

**Example\_SoundPreset**\
If you want a starting point for your [SoundPreset](/docs/soundpreset.md), look at the Example\_SoundPreset. \
Note: The [SoundContainers](/docs/soundcontainer.md) and [SoundEvents](/docs/soundevent.md) have volume -12dB so you can increase the volume later.\
You can compensate by increasing the volume in the AudioMixer.\
All the [SoundEvents](/docs/soundevent.md) are also assigned to a AudioMixerGroup in the Example\_AudioMixer.

### **Example Templates**

**Template Default (Matches to all to catch any stray sounds without prefix)**\
Default settings\
Outputs to SFX

**Template AMB (2D Ambience)**\
Distance disabled\
Spatial Blend 0

**Template MUS (Music)**\
Distance disabled\
Spatial Blend 0\
Never Steal Voice\
Never Steal Voice Effects\
Priority 1

**Template SFX (Sound Effects)**\
Default settings

**Template UI (User Interface)**\
Distance disabled\
Spatial Blend 0

**Template VO (Voice/Dialogue)**\
Random Pitch disabled

### Settings

**Disable All**\
If disabled no settings from the [SoundPreset](/docs/soundpreset.md) will be applied automatically and not available in the preset menus.

### Preset

**Disable**\
If disabled this specific preset won’t be available.

**Automatic Loop**\
If enabled and the [SoundContainer](/docs/soundcontainer.md) name contains “loop” then it will automatically enable “Loop”, “Follow Position”, “Stop if Transform is Null” and “Random Start Position”.\
This will be applied after all the other settings are copied.\
Is not applied if you manually select a preset from the [SoundContainer Presets](/docs/soundcontainer.md#presets) dropdown.

**From SoundContainer**\
The [SoundContainer](/docs/soundcontainer.md) you want to copy the settings from.\
Copies everything except:

* AudioClips

**From SoundEvent**

The [SoundEvent](/docs/soundevent.md) you want to copy the settings from.

Copies everything except:

* SoundContainers
* Timeline Settings
* Intensity Scale Add/Multiplier
* TriggerOn SoundEvents
* SoundTag SoundEvents

### Match

**Auto Match**\
If enabled then automatic matching will be used when you [Create Assets From Selection](/docs/sonity/create-assets-from-selection.md) and in the [SoundContainer Presets](/docs/soundcontainer.md#presets) and the [SoundEvent Presets](/docs/soundevent.md#presets) “Auto Match”.\
Disable if you just want presets to apply manually to your assets.\
Auto matching is not case sensitive.

**Apply On All**\
If enabled the settings assigned will be applied to all assets on asset creation and “Auto Match”.\
Useful to combine with other settings with conditions added later in the chain to assign settings to assets which doesn’t match the names.

**Is Prefix**\
If the prefix of an asset matches the strings, the settings will be applied.\
Example prefixes: “AMB”, “MUS”, “SFX”, “UI”, “VO”.

**Is Not Prefix**\
If the prefix of an asset doesn’t match the strings, the settings will be applied.

**Contains**\
If the name of an asset contains the strings, the settings will be applied.

**Not Contains**\
If the name of an asset doesn’t contain the strings, the settings will be applied.
