# 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="/files/1AuKT6K4P3mT6TiooNmV" 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="/files/uyjffdGIS2NABdeNwlPH" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.emaildelivery.com/docs/transactional/transactional-tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
