Special Tags

Special tags can be used to customize messages based on commonly used data in Bronto.

Special tags represent the default tags that we provide in your account. When an email or SMS message is sent, special tags are replaced with data from your account.

The different types of special tags are described below.

Special Tag Name Special Tag Syntax Description
Recipient Email %%!contact_email%% or %%email%% Adds the contact's email address.
Recipient External Id (Email Only) %%!contact_eid%% Displays the external id of the contact. This is the same id used in the API.
Recipient Mobile Phone Number %%!contact_mobile_phone_number%% Displays the mobile phone number stored for the contact.
Recipient Twitter Account %%!contact_twitter%% The contact's Twitter name/handle, if present.
Recipient Facebook Account %%!contact_facebook%% The first and last name used in a contact's Facebook profile, if present.
Recipient Created Date/Time %%!subscribe_date%% Displays the date the contact was created in the date format you have choose for your account.
Recipient Created UTC Timestamp %%!subscribe_timestamp%% Displays the contacts creation date and time in the date format you have chooses for your account, plus "-h:mm(am|pm)". For example, 06/06/2008-6:13pm.
Reply Tracking Email (Email Only) %%!reply_email%% Adds the email address provided when you enable Reply Tracking for an email message.
Company Contact First Name %%!account_firstname%% The first name added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company Contact Last Name %%!account_lastname%% The last name added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company Name %%!account_organization%% The organization name added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Formatted Company Address (Email Only) %%!account_address%% The fully formatted full address that is added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).

Using this tag will add something similar to: Bronto | 324 Blackwell St. | Durham, NC 27701 | United States

Company Telephone %%!account_telephone%% The telephone number added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company Email %%!account_email%% The email address added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company Address 1 %%!account_address1%% The first line of the address added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company Address 2 %%!account_address2%% The second line of the address added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company City %%!account_city%% The city added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company State %%!account_state%% The state added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company Zip %%!account_zip%% The zip code added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Company Country %%!account_country%% The full name of the country added in the contact information section on the Contact Information Settings page (Go to Settings > Account Information > Contact Information).
Manage Preferences URL (Email Only) %%!manage_url%% Provides a link to the Manage Preferences webform which allows contacts to unsubscribe and/or edit any information you are storing - email address, name, phone number, etc. This should never be used as an image link.

By default, this tag will use the default Manage Preference webform for your account. To use a specific webform, add _webformID after url. For example, %%!manage_url_17702%%. You can find a webform's ID on the Webforms page.

Unsubscribe URL (Email Only) %%!unsubscribe_url%% Provides a direct link to the Unsubscribe page. The contact will still be presented with a button to press to confirm this action. This link, unlike Manage Preferences, does not provide the ability to change email address or update contact information. This should never be used as an image link. Using an image for an unsubscribe link will make your message more likely to be flagged as SPAM by email client filters. Email filters cannot easily recognize an image as an unsubscribe link.

By default, this tag will use the default Unsubscribe URL webform for your account. To use a specific webform, add _webformID after url. For example, %%!unsubscribe_url_17702%%. You can find a webform's ID on the Webforms page.

Complaint URL (Email Only) %%!complaint_url%% Adds a link to the Complaint webform.

Complaint webforms allow contacts to report unsolicited email they have received from you. When a contact submits a Complaint webform, they will be unsubscribed and marked as Inactive. Providing a simple way for contacts to report unsolicited email helps to ensure that you only send to contacts who want to receive email from you.

By default, this tag will use the default Complaint URL webform for your account. To use a specific webform, add _webformID after url. For example, %%!complaint_url_17702%%. You can find a webform's ID on the Webforms page.

Forward to Friend URL (Email Only) %%!forward_url%% Provides a link to a Forward to a Friend form which allows the contact to forward the email message to a colleague and includes a personal message at the top.
Message URL (Email Only) %%!message_url%% The %%!message_url%% tag allows the contact to click through to view the email in a browser outside of their email client. This may be helpful if the contact doesn't know how to load images, is seeing a malformed email due to rendering issues, or is viewing a text only version of the email. This should never be used as an image link. In the HTML version of the email message, only a URL linking to the email message is added. In the plain text version of the email message, this tag includes the text "View an HTML version of this message:" followed by the link to the email message. If you add text around the %%!message_url%% tag in the HTML version of the email message, remember that the "View an HTML version of this message:" will still be appended to the tag in the text version of the email message. If you add text around the %%!message_url%% tag in the HTML version of your email message, use the %%!preview_url%% tag described below in the text version of your email message, instead of the %%!message_url%%.
Message Name %%!message_name%% The %%!message_name%% tag allows you to insert the message name.
Text Message URL (Email Only) %%!text_message_url%% Provides a link to the online text version of the email message.
Message Subject (Email Only) %%!subject%% Displays the subject line used for the email message
Message Id %%!message_id%% The id associated with the version of the message used in the delivery.
API Message Id %%!message_api_id%% The API id for the message used in the delivery.
Confirm URL (Email Only) %%!confirm_url%% URL to Confirm Subscription to List; Use this tag in confirmation/subscription email messages.
Month (name) %%!month%% Full month name. e.g. December.
Month (numeric) %%!month_num%% Numerical value for the month e.g. If it was December, then 12 would be displayed.
Year (numeric) %%!year%% Full year, e.g. 2008.
Day of Month (numeric) %%!day_of_month%% The day of the month e.g. a numerical value of 1 to 31 depending on the day.
Day of Week (e.g. Sunday) %%!weekday%% Day of week, e.g. Friday.
Formatted Date (e.g. July 4, 2008) %%!date%% English version of the date, e.g. October 12, 2008
Custom Date Format Tags %%!formatdate.(<format>).(<field>)%% Allows dates to be formatted according to custom format strings.
  • (<format>) is a optional date format String. This table lists the allowed characters that can be used in date formats. If not specified, your site's formatting preferences are used.
  • (<field>) is an optional date type contact field. When provided, the value of this field is the date used. When not provided, the send date will be used.
Some examples of how this may be used:
  • %%!formatdate.(YYYY/MM/dd)%% for the send date in year, month, day format.
  • %%!formatdate.(MM dd).(contactfield)%% for the contact field date in month and day format. For example, you might want to use the birthday contact field.
Apply Basic Math To Date Tags %%!formatdate.(<format>).(<field>).(<math>)%% Allows dates to be formatted according to custom format strings and provides functionality for simple math operations on a date, such as adding two weeks.
  • (<format>) is a optional date format String. This table lists the allowed characters that can be used in date formats. If not specified, your site's formatting preferences are used.
  • (<field>) is an optional date type contact field. When provided, the value of this field is the date used. When not provided, the send date will be used.
  • (<math>) is an optional math String that can use plus or minus with a numeric time measurement that can be any of YMWDhms. (Year, Month, Week, Day, hour, minute, second)
Some examples of how this may be used:
  • %%!formatdate.(YYYY/MM/dd).().(-2W)%% to target two weeks before the send date.
  • %%!formatdate.().(subscriberfield).(+1M)%% for one month after the send date using your site's default date format.
UTC Timestamp %%!utctimestamp%% UTC timestamp, e.g. 2009-01-22 21:00 UTC
Forward To A Friend Note (Email Only) %%#!ftaf_note%% Displays the content added to the Note to Friend special purpose content block in the default Forward to a Friend webform in your account.
Tip: For more information on the Note to Friend special purpose content block used in webforms, see Add Special Purpose Content Blocks To Your Webform.

By default, this tag will use the default Forward To A Friend webform for your account. To use a specific webform, add _webformID after url. For example, %%!ftaf_url_17702%%. You can find a webform's ID on the Webforms page.

N/A %%!preview_url%% (Email Only) The %%!preview_url%% tag only works if you add it to the text version of an email message. It provides a URL that links to the email message with no appended text. No additional text is included in the plain text version of the email message, as is the case with the %%!message_url tag. Use the %%!preview_url%% in place of the %%!message_url%% tag in the text version of your email message if you have text around the %%!message_url%% tag in the HTML version of your email message.
N/A %%!success%% (Email Only) Mainly for use in the webform displayed to contacts when they successfully submit another webform. This tag displays the text added in the Success Message text box on the Form Settings page for the webform being submitted.
Warning: The %%!tracksent_key%% special tag was deprecated for all new messages effective May 2010.