Fragments insert in the template at the position of the {{insertEmailFragments}} token. Since this token should be enclosed in a <table> tag, fragments must be enclosed in a <tr> tag to ensure they render correctly. Fragments can contain images and relationships to multiple Vault documents or any number of external href links.

Do not include tokens in commented out sections of Approved Email content.

Fragments can be shared between different Email Templates of the same product, so the HTML design should be consistent.

Example Email Fragment Structure

1
2
3
4
5
6
7
8
<tr>
  <td>
    <!-- Content goes here. Styles can be inline or can reference the <styles> tag of the template -->
    <!-- Images are stored externally or in Vault -->
    <a href="{{PieceLink}}">Creates a link to a Promotional Piece Vault document</a>
    <a href="{{ISILink}}">Creates a link to an Important Safety Information Vault document</a>
  </td>
</tr>

Linking a Vault Document in a Fragment

Admins can quickly and safely link a Vault PromoMats document in a fragment using the following tag:

<a href="{{$Vault Document ID}}">This text displays as the link</a>

When the end user includes a fragment with a link to a Vault document and selects Send, Approved Email validates that the corresponding document is in a Steady State. if the email contains any links to a Vault document that is not in a Steady State, the email is not sent. This ensures only approved and compliant content is sent by end users.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<tr>
  <td>
    <table>
      <tr>
        <td>
          <!-- Content goes here. Styles can be inline or can reference the <styles> tag of the template -->
          <!-- Images are stored externally or in Vault -->
          <a href="{{$20}}">Creates a link to the Vault document with an ID of 20.</a>
          <a href="{{$87}}">Creates a link to the Vault document with an ID of 87.</a>
        </td>
      </tr>
    </table>
  </td>
</tr>

Once the fragment has been coded and locally tested, it must be uploaded to Vault. See How to Set up Email Fragments in the Vault documentation for more information.