Predefined Links

From Enterprise Help
This is the approved revision of this page, as well as being the most recent.
Jump to: navigation, search

By placing certain types of "predefined link" merge codes in your e-mail messages, you can instruct Enterprise to generate links to your Member Pages, Forward-to-a-friend links, and links to an online version of your message. The codes are not case-sensitive.


The following predefined links can be used in the context of Mailings (HTML Body, Text Body, From Name, From Address, Reply To, and Subject), but not in any Site Settings or in the Online Version of messages.


  • Unsubscribe (Current List): You can insert a "one-click" unsubscribe link in your message that will allow the user to unsubscribe from the current mailing list (the mailing list to which the message will be sent) just by clicking on the link. The code for generating an unsubscribe URL is ##_Unsubscribe_##. Here is an example usage in an HTML message:
To unsubscribe from future mailings, click <a href="##_Unsubscribe_##">here</a>.
  • Unsubscribe (Current List) with Theme: The ##_Unsubscribe('MyTheme')_## merge code is similar to "Unsubscribe (Current List)", but it produces a link to a Theme-specific unsubscribe page. The "MyTheme" keyword should be replaced with the name or ID value of the desired Theme. Either single-quotes or double-quotes can be used around the Theme name/ID, but in the following example it's preferable to use single-quotes because there are already double-quotes around the entire merge code (as required by HTML standards):
To unsubscribe from future mailings, click <a href="##_Unsubscribe('MyTheme')_##">here</a>.

In this example, the ID value of the Theme is specified, rather than the name:
To unsubscribe from future mailings, click <a href="##_Unsubscribe('4294967295')_##">here</a>.

  • Online Version: If you have created an online version of your message, you can automatically generate a link to it by inserting the ##_OnlineVersion_## merge code. It should not be used in mailings that don't have an online version, as it will produce a link to a blank page. Here is an example of the Online Version merge code:
Having trouble viewing this message?  Click <a href="##_OnlineVersion_##">here</a> for an online version.
  • Forward to a friend: If you have created an online version of your message, you can automatically generate a link which will allow the recipient to "forward to a friend." This link will be rendered as a "mailto" link in the recipient's message, which when clicked will launch a "new message" window. This new message window will be pre-populated with a link to the online version of the message. For example:
Click <a href="##_Forward_##">here</a> to forward this message to a friend or colleague.

  • Forward to a friend (with Theme): Similar to the "Forward to a friend" merge code, but produces a mailto link in which the pre-filled Body and Recipient are Theme-specific. The syntax of this merge code differs from that of the other Theme-specific merge codes in that the Theme name/ID is the second parameter rather than the first, and the first parameter should be empty (two single-quotes or two double-quotes next to each other). Here is an example:
Click <a href="##_Forward(,'MyTheme')_##">here</a> to forward this message to a friend or colleague.


The following predefined links can be used in the context of Mailings (HTML Body, Text Body, From Name, From Address, Reply To, and Subject) and also in various Site Settings, but not in the Online Version of messages.


  • Profile Update Page: You can insert a link to the Profile Update page (i.e., the Member Subscribe Page for existing Member) by placing the ##_Profile_## merge code in your message. When the message to each recipient is generated by Enterprise, a unique ID number for that Member will be embedded in the link. This will allow the Member to access his or her Member Profile page without entering his or her password. Here is an example of how to use the ##_Profile_## code in an HTML message:
To update your profile information, click <a href="##_Profile_##">here</a>.

  • Profile Update Page with Theme: To link to a Theme-specific version of the Profile Update page, use the ##_Profile('MyTheme')_## code in your message. Example:
To update your profile information, click <a href="##_Profile('MyTheme')_##">here</a>.

  • Unsubscribe (All Lists): Similar to "Unsubscribe (Current List)", except that this merge code will unsubscribe the user from all mailing lists, not just the one to which the mailing will be sent. The syntax for generating this URL is ##_UnsubscribeAll_##. Here is an example usage in an HTML message:
To unsubscribe from all mailing lists, click <a href="##_UnsubscribeAll_##">here</a>.

  • Unsubscribe (All Lists) with Theme: Similar to "Unsubscribe (All Lists)", but supports the specification of a Theme. Example:
To update your profile information, click <a href="##_UnsubscribeAll('MyTheme')_##">here</a>.

  • Unsubscribe (Universal): Similar to "Unsubscribe (All Lists)", except that this merge code will unsubscribe the user from all lists in all associated sites, not just the current site. If you only have one site or if your multiple sites are not associated to allow this functionality to work across your sites, the Unsubscribe (Universal) will act as the Unsubscribe (All Lists) when used. If you have multiple sites and are unsure if they are associated to allow use of this functionality, please contact Fishbowl Client Support.
The syntax for generating this URL is ##_UnsubscribeUniversal_##. Here is an example usage in an HTML message:
To unsubscribe from all mailing lists, click <a href="##_UnsubscribeUniversal_##">here</a>.
  • Unsubscribe (Universal) with Theme: Similar to "Unsubscribe (Universal)", but supports the specification of a Theme. Example:
To update your profile information, click <a href="##_UnsubscribeUniversal('MyTheme')_##">here</a>.

  • Delete Member: This merge code produces a "one-click Member delete" link that Members can use to permanently delete their profile—and all corresponding profile data—from the system. Deleting Members is not recommended except to comply with legal requirements, as deleted members can be easily (and perhaps unintentionally) re-added to the system. The syntax for generating this URL is ##_DeleteMember_##. Here is an example:
To permanently delete your member record and unsubscribe from all mailing lists, click <a href="##_DeleteMember_##">here</a>.

  • Delete Member with Theme: Similar to the "Delete Member" merge code, but links to a Theme-specific delete page:
To permanently delete your member record and unsubscribe from all mailing lists, click <a href="##_DeleteMember('MyTheme')_##">here</a>.
  • Login Page: To insert a link to the Member Login page (from which a successfully authenticated Member will be redirected to the Profile Update page), place the "##_Login_##" merge code in the appropriate place in your message. For example, in an HTML message you could use the following code:
To log in and manage your profile, please click <a href="##_Login_##">here</a>.

  • Login Page with Theme: Similar to the "Login Page" merge code, but links to a Theme-specific login page:
To log in and manage your profile, please click <a href="##_Login('MyTheme')_##">here</a>.

  • Subscribed Lists: This merge code will insert a list (one per line) of mailing lists to which the user in subscribed. Hidden lists (those not marked "Display on Member Subscribe Page" on the Edit List screen) will not be included. The syntax for generating this URL is ##_SubscribedLists_##. Here is an sample text-only usage in an Opt-In Body:
You are currently subscribed to the following mailing lists:
 ##_SubscribedLists_##

You are currently subscribed to the following mailing lists:
 ##_SubscribedLists('MyTheme')_##
  • Unsubscribed Lists: This code will insert a list (one per line) of mailing lists to which the user in NOT subscribed. Hidden lists (those not marked "Display on Member Subscribe Page" on the Edit List screen) will not be included. The syntax for generating this URL is ##_UnsubscribedLists_##. Here is an sample text-only usage in an Opt-In Body:
You are not currently subscribed to any of the following mailing lists:
##_UnsubscribedLists_##

You are currently subscribed to the following mailing lists:
##_UnsubscribedLists('MyTheme')_##



The following predefined links can be used in any context, including the Online Version of messages:


  • Subscribe Page: To insert a link to the Member Subscribe Page (for new Members, not existing ones), place the ##_Subscribe_## code in the appropriate place in your message. For example, in an HTML message you could use the following code:
If you received this message from a friend and would like to subscribe, please click <a href="##_Subscribe_##">here</a>.

  • Subscribe Page with Themes: Similar to the "Subscribe Page" merge code, but links to a Theme-specific version of the Member Subscribe Page. Example:
If you received this message from a friend and would like to subscribe, please click <a href="##_Subscribe('MyTheme')_##">here</a>.