How to map and document HubSpot workflows

The problem: nobody can say why a contact enrolled

Most portals start clean. After six to twelve months, with several people building workflows, they rarely are. Each workflow makes sense alone. Together they form a web that no one has written down. The symptoms are familiar to anyone who inherits a portal:

• Two workflows update the same property, and nobody knows which one is supposed to control it. Lifecycle stage and contact owner are the usual victims.
• Nobody can explain why a record enrolled in a workflow, or why it enrolled twice.
• Switching off an old workflow breaks something else, because a list or another workflow depended on a property it set.
• The workflow count looks healthy, but the count alone tells you nothing about whether the automation works as a system.

Documentation helps, but it is only as good as the last time someone updated it, and new workflows rarely get documented when they're built. A good naming convention usually tells the story. What you can really trust is a view of what is actually connected to what, taken from the live portal.

Your options compared

HubSpot sources: View workflow connections, Organize and manage your workflows, Create and edit properties, Monitor your workflow health.

Option 1: Document workflows manually

A spreadsheet inventory is still the right place to start. It forces you to look at every workflow, and it gives the client something they can own. Keep it simple, with one row per workflow:

Fill in "Properties it writes" carefully, because that is where conflicts hide. Put the same one-sentence purpose into the workflow's description in HubSpot, where workflow search matches names and descriptions, and anyone (or any AI assistant) reading the portal later can see it. Whether the inventory lives in a sheet or a markdown file, its weakness is the same: it goes stale as soon as someone builds a workflow without updating it.

Option 2: Use HubSpot's native tools

HubSpot gives you several ways to see connections, each covering one workflow or one property at a time.

• Workflow Connections tab. In the workflow editor, the Connections tab lists the assets the workflow uses, such as lists and properties, and other assets that reference it, such as a list or another workflow.
• Property usage. In Settings > Properties, a property's usage details show which tools use it, including workflows. Some of these details need Data Hub Professional or Enterprise (Create and edit properties). The list doesn't say whether a workflow writes the property or only filters on it, so you still open each workflow to check.
• Go to workflow. This action enrolls a record into another workflow of the same object type, bypassing its triggers, while the record stays in the original (Choose your workflow actions). Look for it when you trace chains.
• Health and automation issues. The Health tab reports workflows needing review and unused workflows (no enrollments for at least 90 days). Review automation issues lists workflows whose enrolled records hit errors (Monitor your workflow health, Troubleshoot common workflow errors).

These tools read the live portal, so they're accurate. What they don't give you is the whole picture: you still assemble the graph yourself, one workflow at a time.

Option 3: Map workflows with HubCreate, step by step

We built Workflow Maps for agencies that inherit portals, run cleanups, and take change requests. A map is an OAuth scan of a connected portal. It is the automation layer only; Portal Audits cover the rest of the account.

1. Connect the portal. In HubCreate, open HubSpot Accounts, pick the portal in HubSpot's account selector, approve the app permissions, and give it an internal name. (Docs: HubSpot Accounts)
2. Run the map. Open Tools > Workflow Maps. Every connected account is listed, with one map per account. Click Run map, or Re-scan to refresh an existing map. (Docs: What is a workflow map?)
3. Read the canvas. Each workflow is a card showing its status and object type. Cards sit in object-type lanes (contacts, companies, deals, tickets, and other objects). Lines show inbound and outbound links: direct workflow enrollment, list membership, or a shared property write that another workflow enrolls on.
4. Filter to what you're changing. Use the toolbar to search by name (press /), filter by status or object, or show No Connections to list standalone workflows. The property filter on the left rail opens the portal's most-used workflow properties. Pick one or more, and the map keeps only the workflows that write or enroll on those properties, which scopes a rename, merge, or archive before you touch HubSpot. (Docs: Navigating the workflow map)
5. Open a workflow. Click a card to open the drawer: enrollment, mapped actions (property writes, enrollments), inbound and outbound connections, audit findings with recommended actions, and a timeline. Open in HubSpot jumps to the workflow in the portal. (Docs: Workflow drawer)
6. Review the findings. The map flags broken enrollments, empty and stale workflows, standalones, duplicate property writes (same property and value), missing triggers, circular dependencies, inactive workflows, and possible name duplicates.
7. Share the report. Every completed map has a public report that anyone with the link can view without a HubCreate login. It includes a health score (the share of workflows with no warning or critical flags), key findings, connections and clusters, a searchable inventory, the most-used properties, and optional partner comments. Re-scan after a cleanup or change request; the map and report URLs stay the same. (Docs: Workflow map report)

Turning the map into documentation

A map shows what is connected. Documentation records why. Use both:

• Decide who controls each shared property. For every property that more than one workflow writes, especially lifecycle stage and owner, name one workflow (or integration) as the owner, and record it in the property's description.
• Write the "why" for each cluster. The report's clusters name a center workflow. Describe each in a paragraph: what starts it, what it changes, and who owns it.
• Check before you switch anything off. Before you replace or archive a workflow, open its card and review the outbound links. If another workflow enrolls on a property it writes, that workflow will change behavior when you turn this one off.

Where HubCreate fits

If a portal has a handful of workflows, HubSpot's Connections tab and a spreadsheet are enough. Workflow Maps help when a portal has dozens or hundreds of workflows and several builders, and when you need to scope a change or cleanup before you quote it.

Workflow Maps are included on every plan: Basic $500/month (5 HubSpot accounts, 3 users), Pro $1,000/month (15 accounts), and Enterprise $3,000/month (unlimited accounts). See Workflow Maps and Pricing.

Related guides: HubSpot workflow cleanup checklist · HubSpot portal audit checklist · How to copy workflows, forms, and properties between HubSpot portals

FAQ

How do I see which HubSpot workflows trigger each other?

Natively, open a workflow in the editor and check its Connections tab, which lists the assets it uses and the lists or workflows that reference it. Search for Go to workflow actions to trace direct enrollment chains. To see every link in the portal at once, including workflows that enroll on a property another workflow writes, use a workflow map such as HubCreate Workflow Maps.

How can I tell which workflows update the same property?

A property's usage details in HubSpot list the workflows that use it, but not whether each one writes the property or only filters on it, so you have to open each workflow and check its actions. HubCreate Workflow Maps let you filter the map to one or more properties and flag duplicate property writes, where two workflows set the same property to the same value.

What should HubSpot workflow documentation include?

For each workflow: name and ID, object type and status, enrollment triggers, the properties it writes, the lists, forms, and workflows it depends on, what it triggers downstream, an owner, and a one-sentence purpose. Put the purpose in the workflow's description in HubSpot too.

Does HubSpot have a workflow map or diagram view?

HubSpot shows connections per workflow in the Connections tab and inside the workflow editor, but we're not aware of a native view that draws every workflow in a portal and their links on one canvas. That portal-wide view is what HubCreate Workflow Maps provide.

Do I need a HubSpot Enterprise subscription to map workflows?

No. Workflows themselves need a Professional or Enterprise subscription in HubSpot. HubCreate Workflow Maps work on any connected portal that has workflows, and they are included on every HubCreate plan, including Basic.

Can I share a workflow map with a client who doesn't use HubCreate?

Yes. Every completed map has a public report link that anyone can open without a HubCreate login. It includes the health score, findings, inventory, most-used properties, and any partner comments you add.