Content Replacement Codes

Table of Contents
List of Content Replacement Codes
Using Replacement Codes in Custom Headers

List of Content Replacement Codes

The following replacement codes may be added to campaigns and autoresponders.

Subscriber ID

The primary key of the subscriber in GreenArrow Studio’s database.

Replacement Code: %%subscriber_id%%

Subscriber’s Email Address

The subscriber’s email address as recorded in GreenArrow Studio.

Replacement Code: %%subscribers_email_address%%

If the subscriber’s email domain is an Internationalized Domain Name, the email address will be replaced in the “punycode” form. See the Subscriber Record documentation for more information on this. This behavior may change in the future.

Subscriber’s Email Address MD5, SHA1, and SHA256

The lowercased MD5, SHA1, or SHA256 hash of the Subscriber’s lowercased email address.

Replacement Code: %%emailaddress_md5%%
Replacement Code: %%emailaddress_sha1%%
Replacement Code: %%emailaddress_sha256%%

If the subscriber’s email domain is an Internationalized Domain Name, the hash will be calculated from the lowercased “punycode” form. See the Subscriber Record documentation for more information on this. This behavior may change in the future.

Mailing List ID

The primary key of the mailing list in GreenArrow Studio’s database.

Replacement Code: %%mailing_list_id%%

Mailing List Name

The unique name assigned to this mailing list.

Replacement Code: %%mailing_list_name%%

Unsubscribe Link

The raw URL that will cause the subscriber to unsubscribe from this mailing list. When the user clicks on this link, they’ll be taken to a page that will remove them from the mailing list. That page contains a form that is automatically submitted using JavaScript. This helps to prevent link-crawling spam-filtering robots from mistakenly removing subscribers from the mailing list.

If the subscriber’s web browser does not support JavaScript, they will be presented with an “Unsubscribe” button to click to finalize their removal from the mailing list.

Replacement Code: %%unsubscribe_link%%

Web Version Link

The raw URL that will lead the subscriber to the web version of this email. This is only available on campaigns.

Replacement Code: %%link_to_web_version%%

Campaign ID

The primary key of the campaign in GreenArrow Studio’s database.

Replacement Code: %%data_campaign_id%%

Deprecated Replacement Code: %%campaign_id%%

Campaign Name

The unique name assigned to this campaign.

Replacement Code: %%data_campaign_name%%

Current Year

The current year in 4 digits (2000). The current year is retrieved using the server’s current time. This value is determined when the replacement is made, not when the campaign was sent.

Replacement Code: %%data_current_year%%

Current Date (Long)

The current date (in the organization’s time zone), formatted like December 5, 2015.

Replacement Code: %%data_current_date_long%%

Current Date (Database)

The current date (in the organization’s time zone), formatted like 2015-12-05.

Replacement Code: %%data_current_date_database%%

Percent %

A simple percent % symbol. This replacement exists because % is used as part of the replacement code anchors, and there may be content that needs this in order to be formed properly.

Replacement Code: %%data_percent%%

From Email

The From Email value used for this message.

Replacement Code: %%data_from_email%%

From Name

The From Name value used for this message.

Replacement Code: %%data_from_name%%

Sender Email

The Sender Email value used for this message. This may be blank.

Replacement Code: %%data_sender_email%%

Reply-To Email

The Reply-To Email value used for this message. This may be blank.

Replacement Code: %%data_reply_to_email%%

Subscriber Date Subscribed (Long)

The date this subscriber subscribed, formatted like December 5, 2015.

Replacement Code: %%data_subscribe_date_long%%

Subscriber Date Subscribed (Database)

The date this subscriber subscribed, formatted like 2015-12-05.

Replacement Code: %%data_subscribe_date_database%%

Subscriber Subscription IP

The IP from which the subscriber originally subscribed.

Replacement Code: %%data_subscribe_ip%%

Subscriber Email Address (Base64 Encoded)

The subscriber’s email address, encoded as base64. Any trailing = characters are stripped from the base64 encoded data.

Replacement Code: %%emailaddress_base64%%

If the subscriber’s email domain is an Internationalized Domain Name, the email address will be encoded to base64 in the “punycode” form. See the Subscriber Record documentation for more information on this. This behavior may change in the future.

If a custom field was created prior to GreenArrow Studio v4.114.0 with a variation of this replacement code name, such as “EmailAddress Base64”, the calculated base64 value will be used in place of whatever data was in the subscriber’s custom field entry.

After v4.114.0, custom fields cannot be created or updated to have a name that would lead to this conflict.

Stat ID

The Stat ID from which the email was sent.

Replacement Code: %%data_stat_id%%

SendID

The SendID from which the email was sent. See GreenArrow Concepts for more information on the value of SendID.

Replacement Code: %%data_sendid%%

Unsubscribe token

This content replacement code can be used in campaigns and autoresponders to have finer control over the unsubscribe process. The token can be used with the Unsubscribe API method to apply the unsubscribe.

Replacement Code: %%unsubscribe_token%%

The token is used instead of an unsubscribe link to have more control over the unsubscribe process. To use the token:

Add a link to your own unsubscribe page passing the token as a parameter. For example:
```
http://www.domain.com/unsub/?token=%%unsubscribe_token%%
```
Implement the unsubscribe page at http://www.domain.com/unsub/. For example, ask for confirmation.
Once unsubscribe occurs on your page, call the Unsubscribe API with the unsubscribe token.

URL Domain

There are two replacement codes for the URL Domain of the campaign or autoresponder.

Replacement Code: %%data_url_domain%%
Replacement Code: %%data_url_domain_with_protocol%%

The %%data_url_domain%% replacement code replaces only the domain name of the URL Domain (i.e. example.com).

The %%data_url_domain_with_protocol%% replacement code replaces both the protocol and domain name of the URL Domain (i.e. https://example.com).

Using Replacement Codes in Custom Headers

To use content replacement codes in custom headers, use double curly braces as delimiters instead of the regular delimiters (%%).

For example, to use %%subscribers_email_address%%, %%subscriber_id%%, and %%data_campaign_id%% in custom headers:

X-Custom-Header1: {{data_campaign_id}}
X-Subscriber-Info: {{subscriber_id}}
X-Contact-Email: {{subscribers_email_address}}

Double curly braces must also be used for Custom Fields in custom headers. For example, to include the Custom Fields First Name and Last Name in a custom header:

X-Custom-Header2: {{Last_Name}},{{First_Name}}