# Triggers and Interactivity Triggers allow defining set of rules for triggering specific `seq` or `par` playlist. ## Defining Triggers The `` element defines a pool of individual `` tags. - whenever the `` is `TRUE`, trigger is set as *activate*. - whenever the `` is `FALSE`, trigger is set as *deactivate*. > The `id` of the `` has to be unique and start with *trigger* key word - e.g. trigger1, trigger-my-content, > triggerABC. ```xml ``` ## Mandatory Sub-Regions for triggered playlist To make sure triggers will work fine with other non triggered content in other regions, you **have to define** a `sub-region` where the triggered playlists are going to be played. Any triggered playlist will be played in the `trigger-sub-region1`. > The `regionName` can be named as you want. There is no restriction. More about the general usage of [Regions can be found here](https://docs.signageos.io/hc/en-us/articles/4405241028114). This is an advanced use case. ### Usage of the sub-regions Sub-region is defined a child tag of another ``. Sub-region is defined as a child tag of another ``. ``` 1. The `trigger-sub-region1` can completely occupy the parent ``: ```xml ``` 2. The `trigger-region` can be split into multiple `sub-regions`. ```xml ``` Having multiple `sub-regions` allows you to play **multiple triggered content** with a dynamic location. The example flow of the dynamically assigning sub-regions is as follows: 1. first, `trigger2` will start playback in the first available sub-region of the `trigger-region` -> `trigger-sub-region1` 1. secondly, `trigger1` will be initiated while still having `trigger2` activated -> the playlist for `trigger1` will be automatically assigned to the `trigger-sub-region2` > Triggered playlist is always looking for the first available (empty) sub-region. If no sub-region is available (all > are occupied by the previously triggered playlists), it overrides the first sub-region. ## Triggering content To trigger content by the pre-defined `triggers` use trigger `id` in the `begin` attribute of the `` or `` element. The triggered playlist is automatically stopped whenever the condition defined in `` is no longer `TRUE`. > For media and other elements **always set region attribute to the parent one**. Never use sub-regions in the region > attribute. ```xml

``` ### Duration of the triggered content If you need the triggered content to play more than one time, you can adjust the number of playback by using `repeatCount`: ```xml

``` Or you can specify `dur` attribute to determine exactly how long should be trigger playing. Dur is specified in seconds. ```xml

```