Skip to main content
Skip table of contents

Email - Linking to documents & websites

Link a button to a URL

Select the Layout which contains the button and go to edit mode. Select the button, click the settings icon and type in an address or document token in the URL field in the right-side menu. This can either be a website or a direct link to a document stored in Veeva PromoMats.

Note that not all websites allow external linking, so make sure to consult with the department responsible for company links if possible.

  • Do not add a URL or Token to the text of the button, as this will not work on buttons, only for regular text.

  • You must use the full URL website path such as https://www.

Link to PDF or other document hosted in Veeva PromoMats.

To insert a link to a PDF or other documents, write the document ID in the URL text area using Vault tokens such as: {{$VaultDocID}} replacing everything after the dollar sign with the document's ID number.

Finding the Document ID in Vault

You can find the document ID as part of the URL of the materials once you have selected it as shown below or as part of the Global ID or Global Version ID.

Example of token use: {{$20797}} - for a document with ID 20797.

Prerequisites in Vault PromoMats

There are some prerequisites that must be in order in Veeva PromomMats for this to work:

  • The document you wish to use must be stored in Veeva PromoMats.

  • The document must be categorized as "Material" and has to be "Approved for Distribution".

  • The document must be allowed for external viewing.

  • The document must also be linked in Vault to the template (EMT) in question as one of the 4 options below, whereof the two first options are the most common:

    • "Other Related Documents". Use token {{$VaultDocID}} 

    • "Related Piece". Use token {{$PieceLink}} 

    • "Related ISI". Use token {{$ISILink}} 

    • "Related PI". Use token {{$PILink}} 

Document Preparation in Vault

If the document is stored in Veeva Vault, it can be called upon via the token {{$VaultDocID}} on buttons in Approved Email in Activator

Check 1: In Promomats

Check 2: External Viewing

Set the External Viewer to allow PDF download for Approved Email

Check 3: Status and Type

Make sure the status and type are set correctly for the content

Check 4: Document link to the template

The PDF or other document must be linked to the Email in Vault in either of these categories. "Other Related Documents" and Related Piece" are most commonly used.

You can find information about tokens on Veeva's Email tokens on their knowledgebase

Link types in Activator

URLs will by default open in another tab when clicked. You can change the behavior by using following combinations:

Type: External

Target: “_blank” is default and will open the link in another tab.

Target: “_self” opens the linked document in the same frame as it was clicked.

Target; “_parent” opens the linked document in the parent frame.

Target: “_top” opens the linked document in the full body of the window.

Type: Anchor

Link to: A list of Layouts used on the canvas. The page will scroll and display the selected layout at the top of the screen when the button is clicked.

Testing

You should generally test if links work by sending a test email via Salesforce to an actual mailbox or using the Activator test email feature: Email Testing

Regular links can be tested from PromoMats in the preview panel and in the Activator, but it is best to test it via a mailbox.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.