Skip to content
Book a build

How do I test a HubSpot workflow before turning it on?

To test a HubSpot workflow, use Test criteria to check whether a record meets the enrollment triggers, then Test in the top right of the editor to preview the path a chosen record would take, action by action. No actions execute, except preview emails sent to you. Event triggers can't be tested for enrollment, so finish by turning the workflow on for a test record.

On this page

What HubSpot supports natively

ToolWhat it doesWhat it doesn’t
Test criteriaShows whether a record meets the enrollment triggers (a record only needs to match one group)Run anything
Test (preview)Pick a record and Automatic or Manual enrollment; see the simulated outcome and timestamp of each action and the path highlightedExecute actions; branches that depend on a previous action’s output may need choosing by hand
Send preview on an email actionSends you the emails on the preview pathSend to the contact
Turn-on choiceEnroll existing records that meet the criteria now, or only future onesLet you turn on for one record only

Branch conditions are evaluated in order, and the record follows the first one it meets. To test another branch, pick it from the dropdown or choose a record that matches it. Testing uses the current version of the workflow, and timing settings can reschedule actions in real runs.

For event triggers such as Property value changed, enrollment can’t be tested; only the AND filters are checked.

How to test a HubSpot workflow before turning it on

  1. Create test records that represent each path: one per branch, plus one that should not enroll.
  2. Run Test criteria on each to confirm who qualifies.
  3. Run Test with each record and check every action’s simulated outcome, especially Edit record values and owner assignments.
  4. Send preview emails to yourself and check personalization tokens against the test record.
  5. Check settings: timing windows, suppression list, goals, re-enrollment.
  6. Narrow the trigger for a live test. Add a temporary filter such as “Email contains your test domain”, turn the workflow on with “only enroll after turning on”, and trigger it with a test record.
  7. Read the action log for the test record, then remove the temporary filter.
  8. Decide on existing records when you remove the filter: enrolling them can send emails to everyone who qualifies today.

Common mistakes

  • Testing one happy path. Most problems are in the branch nobody tested.
  • Testing without the other workflows. A workflow can pass every test and still be overwritten by another workflow afterward. See why a workflow isn’t working with no errors.
  • Removing the test filter with “enroll existing” selected on a workflow that sends email.

Where Jetstack AI fits

HubSpot’s test shows one workflow in isolation. A Jetstack AI Workflow Audit maps the configuration around it across every workflow in the portal, switched-off drafts included: which other enabled workflows enroll from the same lists or write the same properties, which send records into this one, and which read the properties it writes. For the workflow itself, it flags contradictory branches, branches that don’t match the enrollment criteria, re-enrollment with no goal or suppression, and the most emails one path can send in seven days. You walk into your live test knowing exactly which other workflows to check. See how to read the findings.

Sources

Checked October 30, 2026. HubSpot changes its products often; tell us at team@jetstack.ai if something here is out of date.

Workflows & automation

See what needs work before you change it.

A read-only Portal Audit and Workflow Audit score the portal, trace dependencies and turn findings into a branded report.

Explore Portal Audit

Workflows & automation

Related questions.

How do I test a HubSpot workflow before turning it on?

To test a HubSpot workflow, use Test criteria to check whether a record meets the enrollment triggers, then Test in the top right of the editor to preview the path a chosen record would take, action by action. No actions execute, except preview emails sent to you. Event triggers can't be tested for enrollment, so finish by turning the workflow on for a test record.

Does testing change the record?

No. HubSpot says no actual actions are executed. The only exception is Send preview on an email action, which sends the emails on the preview path to you, not the contact.

Why does the test say a record qualifies but it didn't enroll?

The test checks the current version against the criteria. A record can still not enroll, for example if it already completed the workflow and re-enrollment is off.