September 18, 2017
SMTP message tag
This article provides guidance on tagging messages by adding an array of strings to a custom SMTP header. Tagging enables the accumulation of detailed statistics, but the system stores only the first 100 unique tags encountered; therefore, tags should remain consistent and not change frequently. Each tag is limited to 30 characters, and tags starting with an underscore are reserved for internal use; including them will cause errors. To use these tags in campaigns and access detailed analytics, system registration is required; see the dedicated tag registration documentation for details.
-
Tags
- X-Tags: adds tags to outgoing messages using an array of strings in JSON format shielded with backslashes. Each account is limited to 100 tags, with a maximum of 30 characters per tag (tag names range from 2 to 50 characters). Syntax is restricted to numbers, Latin or Cyrillic characters, and the symbols ., -, or _. example: X-Tags: [\"tag1\",I am running a few minutes late; my previous meeting is running over.\"tag2\"].
- X-Message-Priority: adds a priority tag to outgoing emails to prevent delivery delays caused by large promo queues. Priority 1 is the default, with a maximum of 5 levels; values above 5 are automatically capped at 5. example: X-Message-Priority: 2.
- X-Header: allows optional extra headers to be added to the message as a string. example: X-Header: “TemplateExample”.
- X-Ignore-Hard: enables the message to bypass the bounce list when set to true. spam reports and global unsubscribe lists remain active and respected. example: X-Ignore-Hard: “true”.
- X-Ignore-Complaint: enables the message to bypass the spam-report list when set to true. bounce,e, and global unsubscribe lists remain active and respected. example: X-Ignore-Complaint: “true”.
- X-Ignore-Unsubscribe: enables the message to bypass the global unsubscribe list when set to true. spam report and bounce lists remain active and respected. example: X-Ignore-Unsubscribe: “true”.
- X-Ignore-Blacklist: permits the message to bypass all unsubscribes and suppressions in all lists when set to true. This parameter cannot be combined with other bypass filters and is available only to Enterprise Plan users upon activation via support@wooxy.com. example: X-Ignore-Blacklist: “true”.
