How to create a framework
This article walks through building a journey framework: the connected graph of journeys that holds your experience at more than one altitude. You will map the altitudes, create the journey at the top, and connect the journeys beneath it. It is for whoever is setting up a workspace for more than a handful of journeys, and you need journey editing permission at the Structure tier or above to follow it.
One thing to clear up first. There is no Create framework action, because a framework is not a separate object. You build it by creating journeys and connecting them to each other. Everything below is that process.
Before you start: map the altitudes
Sketch the structure before you build anything. On paper is fine, and it will save you a rebuild.
- Write down the one journey that describes the whole customer relationship end to end. That is your top altitude.
- List the major experiences inside it, such as "Buying a phone" or "Making a claim".
- For each of those, note the tasks detailed enough to deserve a journey of their own. Mark any that appear under more than one experience: those are the ones you will build once and connect in several places.
- Give each journey a provisional owner.
- For each altitude, write down the decision it supports and who makes it. If an altitude has no decision, you do not need it.
Two altitudes is a real framework. Do not add a third because it looks more complete. See Journey framework zoom levels.
Step 1: create the journey at the top
- Open the journey library from the left sidebar.
- Create a new journey, following How to create a journey.
- Name it for the whole relationship, for example "Customer lifecycle".
- Set its phases to the major stretches of the relationship. On a lifecycle journey these are broad, such as
Try,BuyandUse. - Add steps only where you will connect something or attach a metric. This journey is a dashboard, not a map, so resist mapping it in detail.
Tip: if your organization has a journey template for lifecycle journeys, apply it here instead of building phases by hand. Templates are managed in
Settings > Journey templates.
Step 2: add a Nested journeys lane
The lane is what lets a journey hold other journeys.
- Open the journey you just created.
- Add a lane from the lane header.
- In the
Add lanemenu, chooseNested journeysfrom the building block lanes group. - Name the lane for what it holds, for example "Journeys".
The lane runs across every step, so each step can now hold one or more journeys.

Step 3: connect the journeys underneath
Work through your sketch one journey at a time. The order of these two options matters: look for an existing journey first.
- Find the step where that experience begins.
- In the
Nested journeyslane on that step, link the journey. If the journey already exists in the workspace, link it rather than creating a new one. - Only create a new journey here when nothing suitable exists. Then open it and build out its phases and steps as normal.
- If the same experience also belongs under a different step or a different parent, connect it there too. It stays one journey with one owner and one set of evidence, reachable from both places.
- Repeat until every journey on your sketch is connected.
Then apply the same move one altitude down: open a journey from the row you just built, give it its own Nested journeys lane, and connect its children. A framework is this one move repeated at each height.
Note: connecting is a link, not a copy. The journey stays a normal journey in the library, editable in its own right, with its own owner and permissions. Nothing about being connected makes it subordinate.
Step 4: pin the framework in the sidebar
So people can find it without searching:
- Open the
Journey frameworkssection in the left sidebar. - Add your top journey to it using the search popover.
- Drag to reorder if you are pinning more than one.
Pinned journeys appear with their nested journeys underneath, which gives your team a permanent map of the structure in the navigation. Adding pins requires journey management permission.
Step 5: walk it once as a reader
Before telling anyone it exists:
- Open the top journey and confirm every journey card sits on the step you expect.
- Click into a few of them and confirm they open the journey you meant.
- Confirm anything that should be shared is connected in every place it belongs, rather than existing twice under different names.
- Confirm every journey has an owner.
- Confirm the naming is consistent within each altitude.
If your workspace shows an Observatory page, it is worth a look here: it draws the whole structure as a graph, which makes a missing connection or an unconnected journey obvious in a way the canvas does not.
Use AI to create a framework
Another way to design a framework, especially if you have a sketch on paper, in a Miro board or written down in a file: giving that to the TheyDo agent is a powerful way to get a full framework built out.
- Open TheyDo’s Agent by clicking Ask TheyDo
- If you already have other types of source data in the data hub, you can let the agent reference that as well
- Paste or add your sketch and tell it to design the full framework
- When it’s done, you can click through and start making adjustements if needed
Pro Tip: Tell the agent to work in stages. First confirm the structure with you before executing the next step helps to give you control.
Using a template
If there are pre-defined templates available in your organization, made by the admin team, you can skip the above and start straight from any template that’s been made available.
Where to go next
How to use frameworks in practice covers the day to day: moving between altitudes, reading progress that rolls up, and keeping the structure current as the portfolio grows.