---
title: SuperTags
description: SuperTags allows you to specify a single metadata key for which SocketLabs will extract the associated values from each message and aggregate performance across those values for analytical purposes.
---
[Skip to content](https://help.socketlabs.com/docs/supertags#main-content)
English
Show submenu for translations
[Contact us](https://help.socketlabs.com/docs/kb-tickets/new?hsLang=en)
[](https://www.socketlabs.com/)
Open main navigation
Close main navigation
- English
Show submenu for translations
- [Contact us](https://help.socketlabs.com/docs/kb-tickets/new)
SocketLabs is here to help!
- There are no suggestions because the search field is empty.
1. [Help Center](https://help.socketlabs.com/docs?hsLang=en)
2. [Advanced](https://help.socketlabs.com/docs/advanced?hsLang=en)
# SuperTags
## SuperTags allows you to specify a single metadata key for which SocketLabs will extract the associated values from each message and aggregate performance across those values for analytical purposes.
SuperTags are currently only available to SocketLabs Enterprise and Spotlight Reporting customers.
SuperTags should not be unique per message. Like a MailingID, the purpose of a SuperTag is to provide an additional field for segmentation and reporting on of a grouping of messages.
### Adding SuperTags when sending via SocketLabs
1. Add metadata to your messages as outlined in our [Metadata and Tags](https://help.socketlabs.com/docs/metadata-and-tags?hsLang=en) article.
2. Then from your server, under Configuration -\> Server Settings, add the singular key that you would like to establish as your SuperTag.
3. For Subaccounts the SuperTag Key configuration can be found on the Edit Subaccount Page:
### Adding SuperTags for Spotlight Reporting
1. Add metadata to your messages as outlined in the documentation for your sending infrastructure
1. [Sendgrid (custom\_args)](https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send#:~:text=for%20more%20information.-,custom_args,the%20personalizations%20level.%20Total%20custom_args%20size%20may%20not%20exceed%2010%2C000%20bytes.,-send_at)
2. [Mailgun (X-Mailgun-Variables)](https://documentation.mailgun.com/docs/mailgun/user-manual/tracking-messages/#attaching-data-to-emails-via-api)
2. Then, from your Connector Settings, add the singular key that you would like to establish as your SuperTag:
### SuperTags in Reporting
SuperTags will be included as a filterable option in aggregate and detail reporting within the server/subaccount.
SuperTags will also have a unique StreamScore generated for each value:
- [Fundamentals](https://help.socketlabs.com/docs/fundamentals?hsLang=en#main-content)
- [StreamScore](https://help.socketlabs.com/docs/fundamentals?hsLang=en#streamscore)
- [Reports](https://help.socketlabs.com/docs/fundamentals?hsLang=en#reports)
- [Frequently Asked Questions](https://help.socketlabs.com/docs/fundamentals?hsLang=en#frequently-asked-questions)
- [Advanced](https://help.socketlabs.com/docs/advanced?hsLang=en#main-content)
- [Security](https://help.socketlabs.com/docs/advanced?hsLang=en#security)
- [DNS Authentication](https://help.socketlabs.com/docs/dns-authentication?hsLang=en#main-content)
- [DKIM](https://help.socketlabs.com/docs/dns-authentication?hsLang=en#dkim)
- [SPF and Custom Bounce Domain](https://help.socketlabs.com/docs/dns-authentication?hsLang=en#spf-and-custom-bounce-domain)
- [Deliverability](https://help.socketlabs.com/docs/deliverability?hsLang=en)
- [For Developers](https://help.socketlabs.com/docs/for-developers?hsLang=en#main-content)
- [Event Webhooks](https://help.socketlabs.com/docs/for-developers?hsLang=en#event-webhooks)
- [Integrations](https://help.socketlabs.com/docs/integrations?hsLang=en#main-content)
- [Languages and Frameworks](https://help.socketlabs.com/docs/integrations?hsLang=en#languages-and-frameworks)
- [Mail Servers](https://help.socketlabs.com/docs/integrations?hsLang=en#mail-servers)
- [Web Clients and Plug-ins](https://help.socketlabs.com/docs/integrations?hsLang=en#web-clients-and-plug-ins)
- [Mail Clients](https://help.socketlabs.com/docs/integrations?hsLang=en#mail-clients)
- [Marketing Tools](https://help.socketlabs.com/docs/marketing-tools?hsLang=en#main-content)
- [Tips and Tricks](https://help.socketlabs.com/docs/marketing-tools?hsLang=en#tips-and-tricks)
- [Troubleshooting](https://help.socketlabs.com/docs/troubleshooting?hsLang=en#main-content)
- [SocketLabs Inbound SMTP Gateway Errors](https://help.socketlabs.com/docs/troubleshooting?hsLang=en#socketlabs-inbound-smtp-gateway-errors)
- [SocketLabs Outbound SMTP Errors](https://help.socketlabs.com/docs/troubleshooting?hsLang=en#socketlabs-outbound-smtp-errors)
- [Spotlight Email Analytics](https://help.socketlabs.com/docs/spotlight-email-analytics?hsLang=en)
- [Hurricane MTA](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#main-content)
- [Advanced Hurricane Usage](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#advanced-hurricane-usage)
- [Upgrading Hurricane](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#upgrading-hurricane)
- [Troubleshooting](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#troubleshooting)
- [Hurricane Maintenance](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#hurricane-maintenance)
- [Getting Started with Hurricane](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#getting-started-with-hurricane)
- [Basic Hurricane Usage](https://help.socketlabs.com/docs/hurricane-mta?hsLang=en#basic-hurricane-usage)
- [Complex Sender](https://help.socketlabs.com/docs/complex-sender?hsLang=en)
[](https://www.socketlabs.com)
Copyright © 2026, SocketLabs LLC