How to Use Custom Tokens in HubSpot Workflow Emails

Custom tokens in HubSpot let you personalize automated emails with dynamic data from deals, tickets, quotes, and other records linked to enrolled objects. When you configure these tokens correctly, you can send highly relevant workflow messages without writing separate emails for each contact or company.

This guide walks you through how custom tokens work, how to add them to automated emails, and how to configure them at the workflow level so your content always displays the right information.

What Are Custom Tokens in HubSpot Workflows?

In HubSpot workflows, custom tokens are placeholders that pull in values from associated records at the time an email is sent. They go beyond standard personalization tokens, which typically use contact or company properties only.

With these advanced tokens, you can reference:

• Deal properties linked to the enrolled contact or company
• Ticket properties related to the object in the workflow
• Quote details, such as quote name or expiration date
• Payment and subscription data in supported accounts

When an email is triggered by a workflow, HubSpot resolves each token based on the specific record associated with that object at send time.

Where Custom Tokens Are Available in HubSpot

Custom tokens are not available everywhere in the tool. Instead, they appear in specific workflow contexts in your HubSpot portal.

You can use them when the following are true:

• You are editing an automated marketing email saved for workflows.
• The email is used in a workflow that enrolls contacts, companies, deals, tickets, or other supported objects.
• The workflow offers a Custom tokens configuration panel in its settings or individual actions.

Because custom tokens rely on associations, HubSpot checks the relationships between the enrolled object and other records (for example, a contact associated to one or more deals).

How HubSpot Chooses Which Record to Use

When multiple associated records exist, HubSpot follows a clear order of operations to decide which one provides values for your custom tokens.

Record Selection Logic for HubSpot Custom Tokens

For each custom token, HubSpot evaluates the enrolled object and its associations in sequence:

1. If the workflow is based on deals, tickets, or another primary object, HubSpot starts with that record.
2. If the token references a related object type (for example, a deal token in a contact-based workflow), HubSpot looks at associated records.
3. If more than one associated record exists, HubSpot attempts to match based on context, like the record that triggered enrollment or meets defined criteria.
4. If no valid value is found, the default text you define in the token settings will appear instead.

This logic ensures that the system can handle complex associations without breaking the email message.

How to Add Custom Tokens to HubSpot Automated Emails

You can insert these tokens directly in the content editor of a workflow email. The options you see will depend on the workflow type and available associations in HubSpot.

Step 1: Open the Email Editor in HubSpot

1. In your account, navigate to Automation > Workflows.
2. Open the workflow that sends the email you want to update.
3. Click the email action, then select Edit to open the email editor.

Step 2: Insert HubSpot Custom Tokens into the Email

1. Place your cursor where you want the dynamic value to appear.
2. Click the personalization or token icon in the rich text toolbar.
3. Choose the appropriate section for custom or workflow tokens (naming may vary by account).
4. Select the property you want to insert, such as a deal amount or ticket ID.
5. Optionally, define default text that will display if HubSpot cannot find a value for a specific recipient.

Repeat these steps anywhere you need personalized content in the subject line or body.

Configuring HubSpot Custom Tokens at the Workflow Level

Adding a token to an email is only part of the process. You also need to configure how HubSpot should resolve those tokens within the workflow itself.

Step 3: Open the Workflow Custom Token Settings

1. Return to the workflow editor after saving your email.
2. Click the workflow settings or the dedicated Custom tokens section (depending on your interface).
3. Review the list of tokens used in all workflow emails.

This list helps you confirm which tokens require configuration and where they are used across your automation.

Step 4: Define the Source Records for HubSpot Tokens

For each custom token, configure how HubSpot should pull data:

1. Select the associated object type, such as deal, ticket, or quote.
2. Specify filters or association rules if available, like choosing the most recent deal or a ticket with a particular pipeline.
3. Set fallback behavior to ensure an email can still be sent even if no record meets the criteria.

By defining clear rules, you help HubSpot accurately resolve each token at send time and avoid unexpected blank fields.

Testing Custom Tokens in HubSpot Workflows

Before activating a workflow, perform tests so that every recipient receives the correct personalized content.

Step 5: Use Test Records and Preview Tools

• Create or identify sample records that mirror real-life data, including deals, tickets, and quotes.
• Use the Test or Review and publish tools in the workflow editor.
• Send test emails to internal addresses using real sample objects so you can see how HubSpot fills the tokens.

Check every token carefully to confirm that values appear correctly and that default text shows when expected.

Best Practices for HubSpot Custom Tokens

To get the best results from these features, keep a few guidelines in mind.

Design Clear Fallbacks

Always add default text for each token. This prevents broken or confusing messages when HubSpot cannot find a value.

Keep Token Usage Focused

Use custom tokens only where they significantly improve relevance, such as:

• Referencing a specific ticket in support follow-up emails
• Calling out a key deal amount or close date in sales sequences managed by workflows
• Highlighting quote details or payment links in transactional messages

Maintain Clean Associations

Make sure that your data structure in HubSpot is accurate:

• Contacts should be associated with the correct companies, deals, and tickets.
• Workflows should enroll the right objects to minimize ambiguity.
• Old or incorrect associations should be cleaned up regularly.

Learn More About HubSpot and Workflow Tokens

To dive deeper into the official documentation and see current interface screenshots, review the original HubSpot knowledge base article on custom tokens in automated emails at this external resource.

If you need expert help designing workflow strategy, personalization rules, and clean data architecture for your HubSpot implementation, you can explore consulting and implementation services at Consultevo.

By combining structured workflows, accurate associations, and carefully configured custom tokens, you can turn your HubSpot portal into a powerful personalization engine for every automated email you send.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`