Quick setup checklist
Use these searches to find contacts based on their current flow activity.
If you know the name of the flow, you can search for contacts who are currently active in it.
Steps:
- Navigate to the Contacts tab
- Click the search bar
- Enter the following query:
Query: flow = "Flow Name"
Replace Flow Name with the exact name of your flow.
[CAPTURE: Show the Contacts page with the search bar containing flow = "test" and results displayed.]
Note: The flow name must match exactly, but the query itself is not case-sensitive.
You can search for contacts who are not currently active in any flow.
Steps:
- Navigate to the Contacts tab
- Enter the following query in the search bar:
Query: flow = ""
This query returns contacts who are not enrolled in any active flow.
[CAPTURE: Show the Contacts page with the query flow = "" and matching results.]
Flow-based searches check current flow activity only.
- The flow query checks current flow activity only
- It does not return contacts who completed a flow in the past
- Contacts interrupted or exited from a flow are treated as not in a flow
Important: Contacts can only be active in one Messaging flow at a time, so each contact will match at most one flow-based search.
Flow-based searches are commonly used to:
- Identify contacts currently mid-flow
- Find contacts safe to start in a new flow
- Troubleshoot stalled or long-running flows
- Combine with sending options or manual flow starts
Tip: Use flow searches before manually starting a flow to avoid unintended interruptions.
Common Issues
My search returns no results for a flow I know is running
Cause: The flow name in the query does not match the flow’s exact name.
Fix: Copy the flow name exactly as shown in the Flows list, then retry flow = "Flow Name".
Contacts who finished a flow do not appear in the results
Explanation: Flow-based searches check only current activity, not historical completion.
Fix: Use Flow Results (or contact history) to review past flow participation.
A contact I interrupted still appears in a flow search
Cause: The page may not have refreshed yet, or the contact is active in a different flow.
Fix: Refresh the Contacts page and confirm the contact’s active flow banner in the contact view.