Information for: DEVELOPERS   PARTNERS   SUPPORT

Global tokens

Global tokens are snippets of text or HTML content that can be added to emails or landing pages. By using global tokens, you can create and use content that should be consistent across multiple emails or landing pages. If the content where you have used a token needs to change, you can update the same in the global token to apply the changes anywhere the token is used. Thus, you avoid the need to manually update every emails and/or landing pages where the token is used.

Note

To get access to the global tokens feature, create a Support ticket.

Creating global tokens

To create a global token:

  1. Log in to Campaign Studio, go to Settings > Global Tokens.

  2. Click +New.

    Creating global token

  3. In Name, specify a name that allows other users to easily identify what the token is used for. For example, Copyright Year, where every year on January 1, you can update the content of the token to reflect the new year.

  4. In Alias, specify the machine name for the token. This value is used in the token you add to emails and landing pages. You can use this value when updating the token content through APIs. If you leave this blank, Campaign Studio automatically generates a value based on Name.

  5. In Content, add whatever you’d like to appear when the token is used in an email or landing page.

    • When you select Type as HTML, you’ll see a WYSIWYG editor to create content that will be converted to HTML with the token (including links, images, and videos).

    • When you select Type as Text, you’ll see a WYSIWYG editor. You can paste HTML code either in code view in the WYSIWYG editor or in the Text field.

    Note

    All styling and alignment, including mobile-responsiveness and MS Outlook compatibility, must be done in the content section. That overrides any alignment or styling applied to the email or landing page block where the token is used.

  6. In Type, select HTML or Text to change the content editor type in Content.

  7. In Published, set the toggle bar to Yes to use global tokens in emails and landing pages. Unpublished tokens appear as blank space if they are used in a published email or landing page.

  8. Click Save & Close.

Using global tokens

Once you’ve created a global token, go to Settings > Global Tokens.

Using global token

Note the value in the Token column for the token you’d like to use. It follows the format of {global-token=alias}, using the alias that you entered when creating the token.

To use the token, add this value in a text block in an email or landing page. The content doesn’t appear in the builder, but can be seen in email and landing page previews.

Important

Do not use a global token or contact token within another global token. Doing so results in unexpected behaviors, including causing the tracking link to be associated with a different customer.