Test your workflow
Last updated: January 19, 2023
Available with any of the following subscriptions, except where noted:
|
|
|
|
Test your workflow to ensure your automation is working as expected.
There are two testing features in workflows:
- Use the Test criteria feature to see which enrollment criteria a specific contact, company, deal, quote, or ticket record meets.
- Use the Test feature to simulate how a specific record will go through a workflow once enrolled.
Test records against your workflow enrollment triggers
To see whether a contact, company, deal, quote, or ticket meets the starting criteria of a workflow:
- In your HubSpot account, navigate to Automation > Workflows.
- Click the name of a workflow.
- Click the Enrollment triggers box.
- In the right panel, click Test criteria.
- In the dialog box, select the record that you want to test. Then click Test [object].
- The right panel will indicate if the record meets or does not meet the enrollment trigger criteria.
- If a record meets the enrollment trigger criteria, it will be enrolled in the workflow when the workflow is turned on if the Yes, enroll existing objects which meet the trigger criteria as of now radio button is selected.
- If a record does not meet the enrollment trigger criteria, it will not be enrolled in the workflow when the workflow is turned on, even if the Yes, enroll existing objects which meet the trigger criteria as of now radio button is selected.
Test records against if/then branches
You can test your if/then branches either individually or by testing all workflow actions to see how an object would go through all branches.
Please note: an if/then branch that has multiple branches can't be tested individually. Instead, use the Test feature to test all workflow actions.
To test an individual if/then branch:
- In the workflow, click the if/then branch.
- In the right panel, click Test criteria.
- In the dialog box, select the record that you want to test. Then click Test [object].
- Test results will appear in the right panel.
- If the record doesn't meet the if/then branch criteria, the panel will display the message Test [object] doesn't meet these requirements. In this case, the record would go down the NO branch.
- If the record meets the if/then branch criteria, the panel will display the message Test [object] meets these requirements. In this case, the record would go down the YES branch.
- If the record doesn't meet the if/then branch criteria, the panel will display the message Test [object] doesn't meet these requirements. In this case, the record would go down the NO branch.
You can test all if/then branches in a workflow by testing a record against all workflow actions.
Test records against your workflow actions
To see how a contact, company, deal, quote, or ticket will proceed through your workflow if enrolled:
- In your HubSpot account, navigate to Automation > Workflows.
- Click the name of a workflow or set up a new workflow.
- In the upper right, click Test.

- In the right panel, click the Preview for dropdown menu and select a record to enroll.
- To receive copies of any emails included in the workflow, select the Send me the emails this workflow would deliver checkbox. Any Send internal email notification emails and Send in-app notification notifications will also be sent to you.
Please note: when previewing workflow emails, HubSpot will use your email address for sending, not the tested contact's email address. If GDPR has been enabled for your account, if your account uses marketing contacts, or if you've unsubscribed from your account's marketing emails, an error will display in the testing panel. You'll need to opt into that subscription type or resubscribe to marketing emails to receive the test email.
- Click Test.
During the test, no actions will be executed. When the test is complete, the right panel will show whether the record meets the enrollment criteria, and the simulated outcome and timestamp of each action.
If your workflow includes if/then branches, the right panel will show the branch the record would take. To preview other possible branch outcomes, click the arrow up icon next to a YES or NO label, then select Yes or No.

Related content
-
Workflows | Frequently Asked Questions
Find answers and general information quickly about the workflows tool in HubSpot. General How do I...
Knowledge Base -
Choose your workflow actions
After creating your workflow and setting enrollment triggers, choose actions to add to your workflow. Actions...
Knowledge Base -
Create workflows
Create a workflow to automate your business processes and make your team more efficient. Set enrollment...
Knowledge Base