Managing Tags

Tags provide a lightweight way to categorize emails for filtering, debugging, and reporting across your Mailofly account.

Adding Tags to Outgoing Emails

Pass tags as an object of key-value string pairs in your API or SDK send call:

await mailofly.emails.send({
  from: "Security <security@acme.com>",
  to: ["member@example.com"],
  subject: "Password Reset Request",
  html: "<p>Click here to reset your password.</p>",
  tags: {
    category: "auth",
    flow: "password_reset",
    tier: "enterprise",
  },
});

Filtering by Tags in Activity Logs

In the Activity Logs view:

Click Add Filter → select Tag.
Enter the key and value (e.g. category = auth).
Only log entries with matching metadata will be displayed.

Tag Constraints

Key length: Up to 64 characters (alphanumeric, dashes, and underscores).
Value length: Up to 256 characters.
Maximum tags per email: 10 pairs.

Related topics

Custom headers and metadata Introduction Variables Send email

⌘I