GuideFix itMarketing HubSales HubService Hub

Why didn't this record enroll? Use HubSpot's Troubleshoot enrollment tool

Skip the guessing. Pick the record, pick the date it should have enrolled, and HubSpot lists every check it passed or failed.

Subscription
Professional or Enterprise
Permissions
Access to view the workflow
Time
8 min · Beginner
Last verified

Short answer

Open the workflow, click Performance history, then Troubleshoot enrollment. Choose the record, choose the moment it should have enrolled, and run the test. HubSpot shows a summary (such as Would enroll) and a list of checks, each marked passed or failed. If a check failed, that is your answer.

1. Open the tool from the workflow editor

Open the workflow from Workflows. In the top right, click Performance history (1) and choose Troubleshoot enrollment (2). The same menu has Enrollment history, Action logs, and Troubleshoot actions.

Performance history menu open with Troubleshoot enrollment highlighted
Performance history (1), then Troubleshoot enrollment (2).

2. Pick the record and the date range

The side panel asks which record you think should have enrolled. Pick it, then set a date and time range. HubSpot lists every moment that record matched any part of the trigger.

Troubleshoot enrollment panel with the record picker and date range highlighted
Record picker and date range. The contact name is blurred.
Possible enrollment dates timeline with two events highlighted
The timeline lists enrollments, unenrollments, and the property changes that matched the trigger. The contact name is blurred.

3. Choose an event and run the test

Each event on the timeline can be tested. Here the event is a property change: Lead status was changed to Open Deal. Click Test on it.

Timeline event Property changed with a Test button highlighted
Test the event that should have caused the enrollment.

4. Read the summary

The summary badge tells you the outcome. Would enroll means the record passed every check and the simulation says it should have enrolled. The panel also links to the Workflow revision at the time, which matters when someone edited the workflow after the event.

Summary showing Would enroll badge and the Workflow revision at the time link highlighted
Summary and the revision link. The contact name is blurred.

5. Read the checks

Below the summary, HubSpot lists the enrollment checks, expandable one by one. In the version I tested there are nine:

  • Record met the enrollment criteria
  • Workflow was turned on
  • No enrollment schedule
  • No conflicting merge settings
  • No conflicting previous enrollments
  • Record isn't currently enrolled
  • No goal criteria
  • Record won't unenroll if it no longer meets criteria
  • No unenrollment lists
Passed enrollment checks expanded with three checks highlighted
Expanded checks. A failed check is flagged in the Issues section above this list.

If the failing check is previous enrollment, read why a contact won't re-enroll.

Data limits

HubSpot keeps 6 months of enrollment history, and the test can be inaccurate when related data is no longer available. Test soon after the miss.

Sources

New field notes by email

One email when a new article publishes.

Still stuck?

If this did not fix it, the problem is probably specific to your setup. Book a call and we will look at it together.

Book a call with Sam