# StreamElements

## Getting Started

The StreamElements feature allows you to connect Mix It Up with your StreamElements account for donation alerts.

This service works with the [StreamElements Donation Event](/docs/integrations/streamelements#streamelements-donation) and [StreamElements Merch Purchase Event](/docs/integrations/streamelements#streamelements-merch-purchase) and additional special identifiers that can be used can be found on the [Donations Special Identifiers](/docs/reference/special-identifiers#donations) page.

## Events

### StreamElements Donation
This event fires when a StreamElements donation is detected. It provides all of the [Donations](/docs/reference/special-identifiers#donations) special identifiers along with all of the standard [User](/docs/reference/special-identifiers#user) special identifiers that represent the user that sent the donation.

### StreamElements Merch Purchase
> **Note:** This event is not currently implemented in Mix It Up. `StreamElements Merch Purchase` exists only as an event-type definition, a localized display name, and a commented-out case in the statistics service. No handler ever fires it, and the `$allitems`/`$totalitems` identifiers are not produced anywhere in the code. The description below reflects the intended design only.

This event is intended to fire when a StreamElements merchandise purchase is detected. As designed, it would provide all of the [Donations](/docs/reference/special-identifiers#donations) special identifiers along with all of the standard [User](/docs/reference/special-identifiers#user) special identifiers that represent the user that sent the donation. The [Argument Special Identifiers](/docs/reference/special-identifiers#arguments) would correspond to each unique item and the amount of that item (EX: $arg1text = "Shirt x2"), and the following additional Special Identifiers would be available:
- $allitems = A comma-delimited list of all the items purchased along with their amounts (EX: "Shirt x2, Mug x4")
- $totalitems = The sum total of items purchased (EX: If 2 shirts and 4 mugs were purchased, this would be "6")