> 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/soundpolygroup.md).

# SoundPolyGroup

Use SoundPolyGroups to limit the polyphony for optimizing your voice count

<div align="left"><img src="https://content.gitbook.com/content/ECYQ2OSoWTLdq4EUgnCW/blobs/D8mcgUccYrkCTMZRF1VX/image10.png" alt="" width="563"></div>

[SoundPolyGroup](/docs/soundpolygroup.md) objects are used to create a polyphony limit shared by multiple different [SoundEvents](/docs/soundevent.md).\
You can assign them in the [SoundEvent settings](/docs/soundevent.md#settings).\
The priority for voice allocation is calculated by multiplying the priority set in the [SoundEvent](/docs/soundevent.md) by the volume of the instance.\
A perfect use case would be to have a [SoundPolyGroup](/docs/soundpolygroup.md) for all bullet impacts of all the different materials so that when combined, they don’t use too many voices.\
If you want simple individual polyphony control, use the polyphony modifier on the [SoundEvent](/docs/soundevent.md).\
All [SoundPolyGroup](/docs/soundpolygroup.md) objects are multi-object editable.

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

**Polyphony Limit**\
The maximum number of [SoundEvents](/docs/soundevent.md) which can be played at the same time in this [SoundPolyGroup](/docs/soundpolygroup.md).

### Sonity GUID

Sonity uses cached GUIDs for object comparison.\
This solves problems where object equality isn't always the same when using e.g. addressables.\
The Sonity AssetPostprocessor automatically saves the GUIDs for objects.\
If you have any missing GUIDs (when upgrading) you can run:\
"Tools/Sonity 🔊/Tools/Reserialize - All Sonity Assets".\
Sonity GUID by [Tobias Johansson](https://www.knackelibang.com/)