Overview
Message variables let you insert metadata about your email message, domain, or Mapp Engage system directly into your message content. This category also includes tags to define which content is shown in the PC or mobile version of a message.
Key Characteristics
Metadata Placeholders: Use placeholders to dynamically insert message-related data such as subject, name, category, and external ID during sendout.
System Information: Add domain or system name variables to personalize content with system-specific values.
Display Targeting: Mark sections of content for either mobile or PC display, enabling responsive messaging within a single email.
How It Works
To use a variable, insert the provided placeholder into your email message. The placeholder format looks like this: <% ... %>. Mapp Engage replaces the placeholder with the actual value during sendout.
Message and System Metadata
These placeholders insert message- and system-specific values during sendout.
Variable | Placeholder | Description |
|---|---|---|
Message Name |
| Inserts the name of the message during sendout. |
Message Subject |
| Inserts the subject of the message during sendout. |
External Message ID |
| A value added to message links during sendout and passed to an external system. You can also add it to a link manually during message creation. |
Message Category |
| Inserts the name of the Message Category during sendout. |
Web Domain |
| Inserts the web domain (http or https) of your Mapp Engage system during sendout. |
Email Domain |
| Inserts the name of the email domain of your Mapp Engage system during sendout. |
System Name |
| Inserts the name of your Mapp Engage system during sendout. |
System Message
Placeholder: <%system_message%>
Use this placeholder when you create system messages with a prepared message. Create the layout of the system message by saving a prepared message as a system message template. In the System Messages area, edit the specific information in the system message (such as the subscribe or unsubscribe confirmation). The variable inserts the system message information into the prepared message template.
For more information, see Use Template for System Message.
Display Targeting: Mobile and PC Content
Mapp Engage lets you build a single email that can be viewed in two versions – one optimized for PC, one for mobile. Use these tags to mark which content belongs to each version. During sendout, the PC content is shown by default, and a link to the mobile version is added automatically at the top of the email. Content that is not tagged as PC or mobile content appears in both versions.
Mobile content
Placeholder: <%InsertIf device="mobile"%> ... <%/InsertIf%>
Marks sections of content that are displayed only in the mobile version. <%InsertIf device="mobile"%> marks the beginning of the mobile content; <%/InsertIf%> marks the end.
You must also include a Read Message Online (Mobile) link. This Mapp Engage Variable is in the System Links category. For more information, see Create a Mobile Version of an Email.
PC content
Placeholder: <%InsertIf device="pc"%> ... <%/InsertIf%>
Marks sections of content that are displayed only in the PC version. <%InsertIf device="pc"%> marks the beginning of the PC content; <%/InsertIf%> marks the end.