Skip to main content

How Veeva Picklist/Custom Text Tokens Work in Knak

Use Veeva Custom Text Tokens as merge tags in Knak. This lets you personalize your assets with values from Veeva.

Before You Begin

Make sure you have the Veeva Custom Text Token provided by your Veeva administrator. You must use the exact format supplied by Veeva. This allows Veeva to return the correct value when your content is sent.

If you plan to use Custom Text Tokens in your email subject line, read Using Custom Text Tokens in Subject Lines first.


Add a Veeva Custom Text Token as a Merge Tag

Step 1: Copy the Veeva Token Format

Use the token exactly as it appears in Veeva. Do not change the formatting.

screenshot of custom text in Veeva

Learn more about Veeva Custom Text Tokens: Configuring Veeva Tokens.

Step 2: Create a Merge Tag in Knak

  1. In Knak, open Admin.

  2. Click Integrations.

  3. Select Merge Tags.

  4. Click Create New Merge Tag.

    Merge Tags page with the Create New Merge Tag button highlighted.
  5. Enter the merge tag details.

  6. Paste the Veeva Custom Text Token into the appropriate field.

  7. Click Save.

    Edit Merge Tag page showing where to paste the Veeva token.

Learn more about merge tags in Knak: No Code and Multi Map Merge Tags.

Use the Merge Tag in Your Asset

After you save the merge tag, you can add it to any supported asset.

  1. Open your email or landing page in the editor.

  2. Place your cursor where you want the value to appear.

  3. Click Tags in the editor toolbar.

  4. Select your merge tag from the list.

The merge tag is inserted into your content. Veeva replaces the token with the correct value when the asset is processed.

Editor toolbar with the Tags menu open and a merge tag selected.

Using Custom Text Tokens in Subject Lines

You can add a Custom Text Token to your email subject line.

⚠️ Important: Before you do, make sure the Custom Email Titles preference is turned on for your account. Contact Knak Support if you do not see a separate Email Title field in the Email Details section.

Why This Matters

If Custom Email Titles is off, Knak uses your subject line as the email title. The email title is the name of the email that is sent to Veeva. So if your subject line has a Custom Text Token, the token also ends up in the email title.

A Custom Text Token in the email title stops all Custom Text Tokens in that email from working. This includes tokens in the subject line and in the body.

When Custom Email Titles is on, you set the email title separately from the subject line. This keeps tokens out of the title, so they work everywhere else in the email.

Add an Email Title and a Token to the Subject Line

  1. Open your email in the editor.

  2. Go to the Email Details section.

  3. Enter a name for your email in the Email Title field. Do not include any Custom Text Tokens in this field.

  4. Add your Custom Text Token to the Subject Line field.

    The Email Details section showing the separate Email Title and Subject Line fields.
  5. Click Save.

Tip: Never put a Custom Text Token in the email title. Keep tokens in the subject line and body only.


Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com.

Did this answer your question?