The hierarchy
Workspace
A workspace is the shared home for one team, product, product area, client, or business unit. It contains members and roles, journeys, building blocks, personas, integrations, notifications, automations, and AI memory or MCP access.Journey
A journey is one customer flow the team wants to understand or improve, such as onboarding, activation, trial to paid, support escalation, or renewal risk.Stage
A stage is a broad phase inside a journey, such as discovery, evaluation, setup, first value, or retention.Step
A step is a specific customer moment inside a stage. Good step names are concrete:Customer reads pricing pageCustomer connects SlackCustomer invites teammate
Item
An item is structured context attached to a step. Items hold touchpoints, insights, opportunities, solutions, and metrics. Items are where the journey becomes useful for decisions instead of staying a static map.The operating loop
Custory is designed around a simple loop:- Customer signals appear in analytics, support, billing, research, or delivery work.
- The team places the signal on the right journey step.
- Items turn that signal into evidence, learning, decisions, and measurement.
- Integrations and automations move follow-up into the tools where work happens.
- Results and shipped changes update the journey again.
Where each part helps
| Part | Use it for |
|---|---|
| Journeys | Mapping and maintaining the customer flow |
| Items | Capturing evidence, decisions, responses, and metrics |
| Building blocks | Reusing canonical items across journeys |
| Personas | Interpreting the journey from the right customer role |
| Integrations | Pulling evidence in and pushing follow-up out |
| Automations | Handling repeated updates, messages, and task creation |
| AI | Summarizing, drafting, and maintaining context from real workspace data |
Example
A trial-to-paid journey might use this structure:- Workspace:
Acme product team - Journey:
Trial to paid - Stage:
Setup - Step:
Customer connects first integration - Item:
Insight about non-technical admins stalling at API credentials