×

Master Hubspot Workflow Data Variables

How to Use Data Variables in Hubspot Workflows

Hubspot workflows become far more powerful when you use data variables to pull in CRM properties and context directly into your automated actions. By inserting these dynamic tokens, you can personalize emails, tasks, and internal notifications without manual updates.

This guide walks you through where data variables appear, how to insert them, and which workflow actions support them so you can build smarter automation.

What Are Data Variables in Hubspot Workflows?

Data variables are placeholders that automatically pull values from records, events, or workflow context. When the workflow runs, Hubspot replaces each variable with real data, such as a contact’s first name, company name, or deal amount.

Data variables help you:

  • Personalize email content and internal notifications.
  • Reference record properties without hard-coding values.
  • Reduce manual data entry in repetitive tasks.
  • Create context-rich automation for sales, marketing, and service teams.

Where You Can Use Hubspot Data Variables

You can insert data variables in several workflow actions. Depending on the type of workflow (contact, company, deal, quote, ticket, conversation, or custom object), different variables are available.

Key places where data variables are supported:

  • Send email actions (marketing emails).
  • Create task actions.
  • Send in-app notification actions.
  • Send SMS actions (where enabled).
  • Custom code or webhook-related fields that support personalization tokens.

Not every field in a workflow action supports variables, so you will only see the variable button where insertion is allowed.

How to Insert Data Variables in a Hubspot Workflow

The method to insert variables is consistent across most actions. Use the following steps whenever you see the personalization or data variable button in a workflow action panel.

Step 1: Open Your Hubspot Workflow

  1. In your Hubspot account, navigate to Automation > Workflows.
  2. Select an existing workflow or create a new one.
  3. Open the workflow editor to see your sequence of actions.

Step 2: Choose a Supported Workflow Action

  1. Click the + icon to add a new action, or select an existing action to edit.
  2. Pick an action that supports variables, such as Send email, Create task, or Send in-app notification.

Within the action editor, look for fields like subject lines, body text, or descriptions. These are common locations where data variables can be inserted.

Step 3: Open the Data Variable Selector

  1. Click inside the text field where you want to insert a variable.
  2. Select the personalization or data variables button (usually represented by a token icon or curly braces).
  3. A panel or pop-up will appear, listing the available variable types.

Step 4: Pick the Right Type of Variable

Depending on the workflow type, you may see categories such as:

  • Contact properties (for contact-based workflows).
  • Company properties (for company-based workflows).
  • Deal properties (for deal-based workflows).
  • Ticket properties or other object properties.
  • Enrollment-related properties, such as the workflow name or timestamp.

Expand the appropriate category and choose the property you want to reference. For example, pick First name from contact properties to personalize a greeting.

Step 5: Insert and Format the Variable

  1. Once you select the variable, click Insert.
  2. The variable will appear in the text field in a token format (for example, a placeholder with the property label).
  3. Type the rest of your message around it, such as: “Hi [First name], thanks for connecting with us.”

When the workflow runs, Hubspot automatically replaces the token with the correct value from the enrolled record.

Using Data Variables in Specific Hubspot Workflow Actions

Send Email Actions in Hubspot Workflows

When using workflow emails, you typically connect to an existing marketing email that already contains personalization tokens. However, you can also configure variables directly in certain email-related fields.

Best practices for email personalization:

  • Use contact-based variables like first name, company, or lifecycle stage.
  • Combine deal or company variables when using deal-based or company-based workflows.
  • Keep subject lines clear and only lightly personalized to avoid spam triggers.

Create Task Actions with Hubspot Variables

Data variables make internal tasks far more informative for sales and service teams.

In a Create task action, you can insert variables into fields such as:

  • Task title – e.g., “Follow up with [Contact name] about [Deal name]”.
  • Task description – provide context like last interaction date, owner, or product of interest.
  • Due date offset descriptions if they support dynamic values.

Always confirm that the field shows the personalization icon before attempting to add variables.

Send In-App Notifications with Hubspot Data

In-app notifications are ideal for alerts to internal users. With data variables, these notifications can include rich context.

You can:

  • Alert owners when a new high-value deal is created.
  • Include ticket details when a ticket reaches a specific stage.
  • Pass along key customer properties for quick triage.

Insert variables into the notification title and body so the recipient immediately knows why the notification matters.

Supported Data Sources in Hubspot Workflow Variables

Variables are not limited to basic properties. Depending on the workflow type and your account configuration, you may see options such as:

  • Object properties (contact, company, deal, ticket, custom objects).
  • Associated record properties, like the primary company of a contact.
  • Subscription or event-related data (where available).
  • Workflow properties including workflow name or enrollment date.

The availability of certain variables may depend on your subscription level and which tools are enabled in your Hubspot account.

Tips for Reliable Hubspot Data Variables

To avoid broken or confusing messages, follow these best practices when designing automation with variables.

Validate Property Data Before Use

  • Make sure key properties (like first name or company name) are populated for most of your records.
  • Use enrollment criteria and lists to limit workflows to records with the necessary data.
  • Consider default values in personalization to handle missing data gracefully, where supported.

Test Your Hubspot Workflow Thoroughly

  • Use test records that represent common scenarios: full data, partial data, and edge cases.
  • Send test emails and run enrollment tests to preview how variables render.
  • Review task and notification previews to confirm the right information appears.

Keep Messages Clear and Human

  • Do not overload a single message with too many variables.
  • Write copy that still reads naturally if some variables are blank or shortened.
  • Use formatting like bullet points to make internal notifications easier to scan.

Additional Resources for Hubspot Workflow Mastery

To explore the full, official documentation on workflow variables and personalization, review the source guide on the HubSpot Knowledge Base: Add data variables to workflow actions.

If you are looking for strategic help implementing advanced automation, CRM architecture, and API-level integrations around Hubspot, you can learn more from Consultevo, a consultancy focused on technical marketing operations.

Recap: Building Smarter Hubspot Workflows with Data Variables

Data variables let you turn static workflow actions into dynamic, context-aware automation. By inserting the right properties into emails, tasks, and notifications, you ensure that every automated touch has the exact information your teams and contacts need.

Start by identifying which workflow actions should be personalized, choose the appropriate variables for each record type, and thoroughly test before going live. With thoughtful use of variables, your Hubspot workflows will be more efficient, accurate, and personalized across your entire customer lifecycle.

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

“`

Verified by MonsterInsights