{"id":31346,"date":"2018-04-21T15:47:45","date_gmt":"2018-04-21T15:47:45","guid":{"rendered":"https:\/\/ampscript.guide\/system-strings\/"},"modified":"2022-07-26T16:25:56","modified_gmt":"2022-07-26T16:25:56","slug":"system-strings","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/system-strings\/","title":{"rendered":"System Strings"},"content":{"rendered":"

System Strings<\/h2>\n

Marketing Cloud includes a library of system-based personalization strings which can be included in a message or on a page to output a value, based on the context of the Subscriber, Contact or a message.<\/p>\n

Email Date Strings<\/h3>\n
\n

NOTE: Date-based personalization strings use the system time (the data center location of your Marketing Cloud account) and appear in US format. However, these values can be transformed using AMPscript date functions<\/a>.<\/p>\n<\/blockquote>\n\n\n\n\n\n\n\n\n\n\n\n
String<\/th>\nDescription<\/th>\nExample Output<\/th>\n<\/tr>\n<\/thead>\n
xtmonth<\/code><\/td>\nFull name of the month when email is sent<\/td>\nJanuary<\/code><\/td>\n<\/tr>\n
xtmonthnumeric<\/code><\/td>\nCurrent month as a number<\/td>\n1<\/code><\/td>\n<\/tr>\n
xtday<\/code><\/td>\nCurrent day of the month when the email was sent<\/td>\n15<\/code><\/td>\n<\/tr>\n
xtdayofweek<\/code><\/td>\nCurrent day of the week when the email was sent<\/td>\nMonday<\/code><\/td>\n<\/tr>\n
xtyear<\/code><\/td>\nCurrent year when the email was sent<\/td>\n2018<\/code><\/td>\n<\/tr>\n
xtshortdate<\/code><\/td>\nCurrent date when the email was sent in short format<\/td>\n01\/15\/2018<\/code><\/td>\n<\/tr>\n
xtlongdate<\/code><\/td>\nCurrent date when the email was sent in long format<\/td>\nMonday, January 15, 2018<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Example<\/h4>\n

This example will update a date field in a Data Extension with the system time when an email is sent, which can be used as a suppression Data Extension for future sends:<\/p>\n

%%[\n\nInsertDE(\"Sent Subscribers\", \"Member ID\", _subscriberkey, \"sent date\", xtshortdate)\n\n]%%<\/code><\/pre>\n
Email Data Strings<\/h3>\n\n\n\n\n\n<\/colgroup>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
String<\/th>\nDescription<\/th>\nExample Output<\/th>\n<\/tr>\n<\/thead>\n
emailname_<\/code><\/td>\nName assigned to the email<\/td>\nSpring Newsletter<\/code><\/td>\n<\/tr>\n
_emailid<\/code><\/td>\nThe system-defined numeric identifier of the email<\/td>\n33345<\/code><\/td>\n<\/tr>\n
_messagecontext<\/code><\/td>\n\n
The context in which the Subscriber viewed the message or page. Either:<\/p>\n
    \n
  • \nSEND<\/code> \u2013 an email that is sent to a Subscriber<\/li>\n
  • \nPREVIEW<\/code> \u2013 an email that is previewed within the email editor<\/li>\n
  • \nVAWP<\/code> \u2013 an email opened as “view as web page” (from a view_email_url<\/code> link in an email)<\/li>\n
  • \nFTAF<\/code> \u2013 an email that is sent as a “Forward to a Friend” message<\/li>\n
  • \nLANDINGPAGE<\/code> \u2013 content is viewed on a landing page, microsite page or CloudPage code resource<\/li>\n
  • \nVALIDATION<\/code> \u2013 email is validated using the validation option in Marketing Cloud<\/li>\n
  • \nLINKRESOLUTION<\/code> \u2013 a URL in an email that is resolved as a click-through link<\/li>\n
  • \nSMS<\/code> \u2013 an SMS message that is sent to a Subscriber<\/li>\n
  • \nSOCIAL<\/code> \u2013 email content that is shared using the Social Forward<\/a> feature<\/li>\n<\/ul>\n<\/td>\n
Refer to Description<\/td>\n<\/tr>\n
_replycontent<\/code><\/td>\nUsed in a Triggered Send Email that has been set as the “Triggered send to forward” option in a Sender Profile when Reply Mail Management is configured. Returns the email body that was included in the reply message.<\/td>\nRefer to Description<\/td>\n<\/tr>\n
_IsTestSend<\/code><\/td>\nResolves to true<\/code> if the email was sent as a Test Send from Email Studio, otherwise the value is false<\/code>\n<\/td>\nfalse<\/code><\/td>\n<\/tr>\n
jobid<\/code><\/td>\nReturns the unique job identifier related to the email send<\/td>\n3210123<\/code><\/td>\n<\/tr>\n
_JobSubscriberBatchID<\/code><\/td>\nA numeric identifier of the batch associated with a Triggered Email; this value defaults to 0<\/code> for a List send<\/td>\n5554321<\/code><\/td>\n<\/tr>\n
_PreHeader<\/code><\/td>\nThe preheader attribute assigned to the email. This string only returns a value when used in an AttributeValue<\/a> function. For example, %%=AttributeValue(\"_PreHeader\")=%%<\/code>\n<\/td>\n30% off store-wide, this weekend only!<\/code><\/td>\n<\/tr>\n
_DataSourceName<\/code><\/td>\nThe value of the List, Group, Sendable Data Extension or Data Extension Filter related to the email send; returns an empty value if the All Subscribers list is used<\/td>\nVIP Members<\/code><\/td>\n<\/tr>\n
_listname<\/code><\/td>\nThe user-defined list name; returns an empty value if the All Subscribers list is used<\/td>\nLoyalty Members<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Subscriber Data Strings<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
String<\/th>\nDescription<\/th>\nExample Output<\/th>\n<\/tr>\n<\/thead>\n
emailaddr<\/code><\/td>\nThe email address of the Subscriber<\/td>\nleon@limedash.com<\/code><\/td>\n<\/tr>\n
firstname_<\/code> or firstname<\/code><\/td>\nThe Subscriber’s first name from the "FirstName" Subscriber Profile Attribute<\/td>\nLeon<\/code><\/td>\n<\/tr>\n
lastname_<\/code> or lastname<\/code><\/td>\nThe Subscriber’s last name from the "LastName" Subscriber Profile Attribute<\/td>\nGreen<\/code><\/td>\n<\/tr>\n
subscriberid<\/code><\/td>\nA system-defined numeric identifier representing a Subscriber<\/td>\n1234<\/code><\/td>\n<\/tr>\n
_subscriberkey<\/code><\/td>\nA user-defined unique identifier representing a Subscriber<\/td>\nM123456<\/code><\/td>\n<\/tr>\n
listid<\/code><\/td>\nThe corresponding list identifier of the Subscriber; returns the All Subscribers list id if the email is not sent to a specific list<\/td>\n12345<\/code><\/td>\n<\/tr>\n
list_<\/code><\/td>\nThe listid<\/code> value suffixed with an underscore character and the email type (either TEXT<\/code> or HTML<\/code>)<\/td>\n12345_HTML<\/code><\/td>\n<\/tr>\n
listsubid<\/code><\/td>\nA system-defined identifier representing the Subscriber’s relationship to the list<\/td>\n987654321<\/code><\/td>\n<\/tr>\n
_messagetypepreference<\/code><\/td>\nThe Subscriber’s preferred email type, as defined as in the HTML Emails Attribute in the Subscriber record; either TEXT<\/code> or HTML<\/code><\/td>\nHTML<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Sender Data Strings<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
String<\/th>\nDescription<\/th>\nExample Output<\/th>\n<\/tr>\n<\/thead>\n
replyname<\/code><\/td>\nThe email From name, retrieved from the Sender Information in the Sender Profile, or the selected user profile<\/td>\nLimedash Corporation<\/code><\/td>\n<\/tr>\n
replyemailaddress<\/code><\/td>\nThe email From email address, retrieved from the Sender Information in the Sender Profile, or the selected user profile<\/td>\nmarketing@email.limedash.com<\/code><\/td>\n<\/tr>\n
memberid<\/code><\/td>\nThe member identifier (MID) of the Business Unit which the email is sent from<\/td>\n6541234<\/code><\/td>\n<\/tr>\n
member_busname<\/code><\/td>\nThe "Company Name" value defined for the Business Unit which the email is sent from<\/td>\nLimedash Corporation, Inc<\/code>.<\/td>\n<\/tr>\n
member_addr<\/code><\/td>\nThe "Street Address" value defined for the Business Unit which the email is sent from<\/td>\n4463 Shinn Street<\/code><\/td>\n<\/tr>\n
member_city<\/code><\/td>\nThe "City" value defined for the Business Unit which the email is sent from<\/td>\nNew York<\/code><\/td>\n<\/tr>\n
member_state<\/code><\/td>\nThe "State\/Province" value defined for the Business Unit which the email is sent from<\/td>\nNY<\/code><\/td>\n<\/tr>\n
member_postalcode<\/code><\/td>\nThe "Zip\/Postal Code" value defined for the Business Unit which the email is sent from<\/td>\n10019<\/code><\/td>\n<\/tr>\n
member_country<\/code><\/td>\nThe "Country" value defined for the Business Unit which the email is sent from<\/td>\nUnited States<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Email URL Data Strings<\/h3>\n\n\n\n\n\n\n\n\n\n\n
String<\/th>\nDescription<\/th>\nExample Output<\/th>\n<\/tr>\n<\/thead>\n
view_email_url<\/code><\/td>\nURL to view the email<\/td>\nhttp:\/\/view.s6.exacttarget.com\/?qs=17f9ecc7fcd5...<\/code><\/td>\n<\/tr>\n
ftaf_url<\/code><\/td>\nURL to a Forward to a Friend form page<\/td>\nhttp:\/\/view.s6.exacttarget.com\/ftaf.aspx?qs=17f9ecce47fcd...<\/code><\/td>\n<\/tr>\n
subscription_center_url<\/code><\/td>\nURL of the Subscriber’s Subscription Center<\/td>\nhttp:\/\/cl.s6.exct.net\/subscription_center.aspx?qs=8ecce2c86ef063c...<\/code><\/td>\n<\/tr>\n
profile_center_url<\/code><\/td>\nURL of the Subscriber’s Profile Center<\/td>\nhttp:\/\/cl.s6.exct.net\/profile_center.aspx?qs=8ecce2c86ef063c31effc761<\/code><\/td>\n<\/tr>\n
unsub_center_url<\/code><\/td>\nURL of the Subscriber’s One-Click Unsubscribe page<\/td>\nhttp:\/\/cl.s6.exct.net\/unsub_center.aspx?qs=8ecce2c86ef063c3...<\/code><\/td>\n<\/tr>\n
double_opt_in_url<\/code><\/td>\nInserts a double opt-in link in an email if this feature is enabled<\/td>\nhttp:\/\/cl.exct.net\/sub_confirm.asp?lst=1234&eml=...<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Reply Mail Management Strings<\/h3>\n
When Reply Mail Management (RMM) is enabled on an account, custom RMM settings can be configured in the sender profile to forward a Triggered Send email to a user or email address, or reply to the Subscriber using a Triggered Send email. This functionality is enabled by checking the ‘Forward using triggered send’ or ‘Reply using triggered send’ options in the sender profile.<\/p>\n
Triggered Send emails used for RMM forwarding or replies can contain personalization strings to extract information from the reply email. These personalization strings can be used with AMPscript to customize the email that is forwarded to a user or email address. Additionally, when the ‘Reply using triggered send’ option is used, the Triggered Send email can include information from the Subscribers’ original reply. Use cases for RMM forwarding and replies with Triggered Send emails include:<\/p>\n