# Transactional tags

{% hint style="warning" %}
**If you use a transactional template that has already been tagged, additional tags used in the header or API request are discarded.**
{% endhint %}

Create transactional mail streams with their own analytics by including a tag with the message.&#x20;

Messages sent without a tag will be grouped together as 'untagged' on the transactional dashboard.&#x20;

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FVfHaq83KfcUQq7pfhPl9%2FScreenshot%202023-11-24%20at%209.46.31%E2%80%AFPM.png?alt=media&#x26;token=90438dd4-e877-4b1d-a6e7-92b1c72ad089" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Transactional messages can be tagged via SMTP Relay, API, or Template methods.**&#x20;
{% endhint %}

* SMTP Relay can use the header X-Transactional-Tag:&#x20;

```
X-Transactional-Tag: signup
```

* API can use the tag parameter:&#x20;

```
"tag": "signup",
```

* SMTP Relay can use the header X-Transactional-Template:

```
X-Transactional-Template: MsmsEaZZDxYyBJyVXXwA2A
```

* API can use the template parameter:

```
"template": "MsmsEaZZDxYyBJyVXXwA2A",
```

{% hint style="info" %}
**Adding a Message Tag to a transactional template will cause all messages that use this template to be tagged automatically.**
{% endhint %}

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FXqMsKottinCcEyxzxOUR%2FScreenshot%202023-11-24%20at%207.40.06%E2%80%AFPM.png?alt=media&#x26;token=746cd2f1-050d-4bb8-9429-4e68aa871a96" alt=""><figcaption></figcaption></figure>
