> 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/how-to-guides/upgrade-sonity.md).

# Upgrade Sonity

Tips on how you can more easily upgrade to the latest version

**Upgrading Sonity**\
Always remove your entire Sonity folder "Assets\Plugins\Sonity".\
If you have any errors, restart Unity after installing the new version.

**Custom Code**\
If you have any custom code you've built into the Sonity scripts, you can always downgrade Sonity to the same vanilla version you added the code to. Then you can see the changes in your version control to see the code diff of what you added (which would now be removed).

**Legacy Support**

<figure><img src="https://3478075546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECYQ2OSoWTLdq4EUgnCW%2Fuploads%2FHViDNKiPXzVCrLOzP9Sb%2FUpgrade%20Sonity%20Legacy%20Support.png?alt=media&amp;token=0c6a999f-08e3-4495-962f-6321af468664" alt=""><figcaption></figcaption></figure>

If any old setting or function in Sonity is removed, there is probably some automatic upgraders or legacy functions hidden behind script define symbols in the Legacy tools menu "Tools/Sonity 🔊/Legacy/".

**Sonity 1.2.0 Assets Upgrade: Reserialize All Sonity assets for new GUIDs**\
When upgrading you might need to run this to save all the new cached GUIDs and names.

**Sonity 1.2.0 Legacy Support: Add Scripting Define Symbol for Legacy Functions Global SoundTag**\
Script define symbol: SONITY\_ENABLE\_LEGACY\_FUNCTIONS\_GLOBAL\_SOUNDTAG

**Sonity 1.1.1 Legacy Support: Add Scripting Define Symbol for Legacy Functions Music and 2D**\
Restores the old PlayMusic & Play2D which were replaced with MusicPlay and UIPlay.\
Script define symbol: SONITY\_ENABLE\_LEGACY\_FUNCTIONS\_MUSIC\_AND\_2D

**Sonity 1.0.6 SoundEvent Upgrade: Convert SoundEvent Modifier Volume and Polyphony to Base**\
Moves any SoundEvent modifier volume and polyphony to the Base Settings in the SoundEvent.

**Sonity 1.0.6 SoundEvent Upgrade: Apply SoundContainer AudioMixerGroup to SoundEvent if None**\
Moves any non null AudioMixerGroup from the SoundContainer to the SoundEvent (if the SoundEvent AudioMixerGroup is null).