Creating Approved Email Fragments
Approved Email fragments are HTML files managed by Vault PromoMats. End users can select one or more fragments to add to an email, enabling greater flexibility and end user customization when composing emails.
Fragments display in the email in the order they are arranged by the end user.
Email Fragment Requirements and Examples
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
<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 Documents 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.
<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>Uploading Fragments in Vault
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.
