Common workflow setting issues
Workflow not triggering
If your workflow is not firing when expected, check the following:1
Verify the workflow is published
Navigate to Automation > Workflows and confirm the workflow status is Published, not Draft. Workflows in draft mode do not execute.
2
Check the trigger configuration
Open the workflow and click on the trigger step. Ensure:
- The correct trigger type is selected (e.g., Form Submitted, Tag Added, Appointment Booked)
- Any required filters are configured correctly
- The trigger is not restricted to a specific form, calendar, or pipeline that does not match the expected input
3
Review enrollment settings
Click on Settings in the workflow builder and check the enrollment options:
- Allow re-entry β If disabled, contacts who have already been through this workflow will not enter it again
- Enrollment filters β Confirm filters are not excluding the contacts you expect to enroll
4
Check for conflicting workflows
If another workflow removes the contact, changes a tag, or moves them to a different pipeline stage before this workflow fires, it can prevent enrollment. Review related workflows for conflicts.
Workflow actions not executing
1
Check for errors in the builder
Open the workflow builder and look for the red error icon on any action step. Click it to see details about missing fields or broken integrations.
2
Review execution logs
Go to the Execution Logs tab and filter by the affected contact. Check the status of each action β look for Failed or Skipped entries and review the error details.
3
Verify action configuration
Open the specific action step and confirm:
- All required fields are filled in
- Custom field mappings reference fields that still exist
- Any linked integrations (email, SMS, webhooks) are still connected and authorized
Wait steps not behaving correctly
Wait steps use the accountβs timezone by default. If contacts are progressing through wait steps at unexpected times, check the timezone setting under Settings > Business Profile.
If/Else conditions routing incorrectly
1
Check condition logic
Open the If/Else step and review each branchβs conditions. Ensure operators (equals, contains, is not empty) match your intent.
2
Verify custom field values
If the condition checks a custom field, confirm the field exists and the contact has a value set. Empty fields may route to the Else branch unexpectedly.
3
Test with a known contact
Use the Test Workflow button, select a contact whose data you know, and verify they follow the expected branch.
Publishing and saving issues
- If the Publish button is grayed out, there are unresolved errors in the workflow. Check for the red error icon on trigger and action steps.
- If the workflow reverts to Draft after publishing, check for required fields or integration errors that prevent a valid publish.
Best practices
- Name your workflows descriptively so you can identify them quickly
- Add internal notes to complex action steps explaining the intended behavior
- Use unique triggers per workflow to avoid race conditions
- Review execution logs regularly to catch issues early
FAQs
Why is my workflow stuck in draft mode?
Why is my workflow stuck in draft mode?
Workflows stay in draft if there are unresolved errors, such as missing required fields or disconnected integrations. Check each step for the red error icon and resolve all issues before publishing.
Can I edit a published workflow without stopping it?
Can I edit a published workflow without stopping it?
Yes, you can edit a published workflow. However, your changes will not take effect until you save and re-publish. Contacts currently in the workflow will continue with the version that was active when they enrolled.
How do I know if a contact was enrolled in my workflow?
How do I know if a contact was enrolled in my workflow?
Go to the Enrollment History tab in the workflow. You can search by contact name or filter by date and status to find specific contacts.