Add Tags Using The Message Editor

With the new message editor you can quickly add field, special, content, RFM, product, and cart/order tags to your messages using the Insert menu. You also have the option of adding tags to the subject line of your message using the drop down arrow to the right of the subject line.

About this task

Instead of being added directly to the canvas, tags are included in messages as part of an element. For example, tags can be added as items in a List element, or used as text or a link for a Button or Image element. This allows for maximum flexibility when you're using a tag.

The Insert menu can be used to add a tag to an element. The menu is accessed from the settings panel for an element after you have added it to the canvas. and is available for all elements except the Spacer and HTML elements. The Insert menu contains a list of all of the tags you can add to a message including
  • Field Tags: The categories of information you have stored for your contacts. Example: %%firstname%% For more information, see Field Tags.
  • Special Tags: The default, Bronto-provided tags. Example: %%!unsubscribe_url%% For more information, see Special Tags.
  • Content Tags: Reusable blocks of content you have created using the Messages > Content Tags page in Bronto. Example: %%@newitems%% For more information, see Content Tags.
  • RFM Tags: The RFM metrics that have been collected for a contact. Example: %%rfm_newest_order_date%% For more information, see RFM Field Tags.
  • Cart/Order Tags: Data collected about shopping carts, if you use the Cart Recovery app, or orders. Example: %%$ For more information, see Adding Cart and Order Data to a Message.
  • Product Tags: The product fields that you have imported into Bronto. Example: %%$product.placeholder.field%% For more information, see Product Tags.
  • Webform Link Tags: A link to a webform that can be added to your message. For more information about webforms, see Webforms.
Note: The Insert menu also includes Special Character, which provides a keyboard you can use to insert special characters.

When you select an option from the list, a menu that contains all of the related tags you have created in your account is displayed. Simply select a tag from this menu and the tag is added to your message. When the message is sent (or sometimes when the message is scheduled) the content of the tag will be replaced with content. For example, if you have a field called firstname used to store the first name of your contacts, and you select this field tag in your message, then the %%firstname%% field tag will be replaced by the value contained in the firstname field for the contact receiving the message. For more information about how tag replacement works, see Message Tags.

If you don't want to use the Insert menu, you can always add tags by hand coding them into your message.

Tip: Any field used in a message must contain less than 1 MB of data.

To add a tag to a message using the message editor:


  1. Open a message in the message editor.
  2. Either
    • Add an element to the message by dragging it from the palette to the canvas.
    • Edit an existing element by mousing over it and clicking the green Edit button.
  3. In the Settings panel, click the Insert button.

    A list of tag options is displayed.

  4. Click on the name of the tag you want to use.

    For example, if you want to include the shipping date for an order, click Cart/Order tag.

    A new window with a list of the available tags is displayed.

  5. Click on the tag you want to use.

    For example, click on Shipping Date.

  6. Click the Insert Tag button.

    In our example, we would click Insert Cart/Order Tag.

    The tag is added to your message.

  7. Optional: If you added a product tag that uses an arbitrary placeholder to your message, you must map the product placeholder to a Product ID. Either:
    Note: If your product placeholder is a contact or API message field, you do not need to map the placeholder.

    To watch a video about using product tags in the message editor, see Add Product Data to Emails Using the Email Message Editor.

  8. Finish your message.
    When the message is sent, the tag is replaced with the content that is relevant to each contact who receives the message.
    Note: A few tags are replaced at the time the message is scheduled. For more information, see Message Tags.