> For the complete documentation index, see [llms.txt](https://helpdesk.smaply.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdesk.smaply.app/journey-maps/how-to-use-the-structure-manager.md).

# How to use the structure manager

Organise a journey map into stages and steps from one panel, and fold away the parts you're not working on.

Lay out the phases and steps of your journey in one list, then rename, reorder, and recolour them without spanning stage cards by hand.

Stages group the steps of a journey, and each step is one column of the map. On a structured map, they sit together in the **Stages & steps** row above your lanes, in place of the column headers. A new **Blank journey** map starts with two stages of two steps each, ready to rename.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-8c501dd42f74bce43a3df3436548e57b849c1267%2Fjourney-maps-structure-01-blank-journey.png?alt=media" alt="A new blank journey map. The toolbar above the map reads Structure, Filter, and Views. The Stages and steps row holds Stage 1 in blue over Step 1 and Step 2, and Stage 2 in yellow over Step 3 and Step 4, on a timeline track. One Text lane below holds one empty card, with each stage&#x27;s colour washed across the lane beneath it."><figcaption><p>A new Blank journey map: two stages, two steps each</p></figcaption></figure>

{% hint style="info" icon="clipboard-list" %}

#### What you'll do

1. [How to open the Structure panel](#how-to-open-the-structure-panel)
2. [How to add, rename, and reorder stages and steps](#how-to-add-rename-and-reorder-stages-and-steps)
3. [How to delete a stage or a step](#how-to-delete-a-stage-or-a-step)
4. [How to recolour stages and switch between Classic and Timeline view](#how-to-recolour-stages-and-switch-between-classic-and-timeline-view)
5. [How to collapse a stage or a lane](#how-to-collapse-a-stage-or-a-lane)
6. [How to manage lanes from the Structure panel](#how-to-manage-lanes-from-the-structure-panel)
7. [How to edit several stages, steps, or lanes at once](#how-to-edit-several-stages-steps-or-lanes-at-once)
8. [How to create a structure on a map without stages](#how-to-create-a-structure-on-a-map-without-stages)
9. [How to go back to regular lanes](#how-to-go-back-to-regular-lanes)
   {% endhint %}

***

#### How to open the Structure panel

Click **Structure** at the left end of the toolbar above the map. The panel opens beside the map with two tabs, **Lanes** and **Stages & steps**, each showing a count. Click **Structure** again to close it.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-bfaf124674b395d042083c00a012e27052b121a9%2Frn-2026-11-structure-manager.png?alt=media" alt="The Structure panel open on the Stages and steps tab. A Timeline view dropdown sits at the top above the hint Drag to reorder, hover a gap to insert. Three stages are listed, Discover, Purchase, and Onboard, each with its steps indented below it, a checkbox on every row, and an Add step link under each stage. An Add stage button sits at the bottom."><figcaption><p>Structure > Stages &#x26; steps</p></figcaption></figure>

You can also open it from the map itself. Every stage and step has a **⋯** menu in the **Stages & steps** row, and the row's heading has a **⋮** menu. **Edit structure** in any of them opens the panel on the **Stages & steps** tab.

***

#### How to add, rename, and reorder stages and steps

Work in the **Stages & steps** tab of the panel:

* **Add a step** - Click **+ Add step** under the stage. The new row opens with its name ready to type.
* **Add a stage** - Click **+ Add stage** at the bottom of the list, or hover the gap above a stage and click the **Add stage** pill that appears. Hovering the gap between two steps and clicking the pill splits the stage at that point.
* **Rename a stage or step** - Click its name in the panel, or in the **Stages & steps** row on the map, and type.
* **Reorder** - Drag a row to a new position. A stage moves with all its steps, and a step can move within its stage or into another one. From the keyboard, **Alt+Shift+Up** or **Alt+Shift+Down** moves the focused row.

To add a stage straight from the map, hover the edge between two stages until a blue **+** and a line appear, then click the **+**. A new stage with one step is inserted at that spot.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-ab574ed4018c6b73b59d068822c054eedddb11e6%2Fjourney-maps-structure-11-map-insert-stage-hover-crop.png?alt=media" alt="The edge between the Discover and Purchase stages on a journey map, with a blue plus button at the top of a blue vertical line running down through every lane."><figcaption><p>Hover a stage edge on the map to insert a stage</p></figcaption></figure>

***

#### How to delete a stage or a step

Open the **⋮** menu on the row in the panel, or the **⋯** menu on the stage or step on the map, and pick one of:

* **Delete stage** - Removes the stage, all its steps, and every card in those steps.
* **Delete step and its cards** - Removes the step's column and every card in it.

When cards would be lost, a confirmation tells you how many steps and cards go with it.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-a79c2169d3757db8181e173f916b75ffeb49c133%2Fjourney-maps-structure-22-delete-stage-confirm-crop.png?alt=media" alt="A confirmation dialog titled Delete stage Purchase. The text reads This also deletes its 2 steps and 5 cards. You can undo this with Cmd+Z. Cancel and a red Delete stage button sit at the bottom."><figcaption><p>The confirmation lists what goes with the stage</p></figcaption></figure>

{% hint style="danger" %}

#### **Warning: Deleting a stage or step deletes its cards**

Move any cards you want to keep into another step first. If you delete something by mistake, press `Cmd+Z` (`Ctrl+Z` on Windows) to undo it.
{% endhint %}

Deleting the only step in a stage deletes the stage too. A map always keeps at least one stage and one step, so the last of each can't be deleted.

***

#### How to recolour stages and switch between Classic and Timeline view

To recolour a stage, hover its row in the panel and click the colour swatch next to the **⋮** menu. Pick a colour, or click **Reset** to go back to the default.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-52a5d5d937a53da77cc2e8f1351fc01a3e858d17%2Fjourney-maps-structure-07-stage-color-picker-crop.png?alt=media" alt="The colour picker open from the Purchase stage row, showing a grid of colours, a Brand colors row with three swatches, a Reset button, and a ticked Color stage background checkbox."><figcaption><p>Stage colour picker</p></figcaption></figure>

With **Color stage background** ticked, which is the default, the stage's colour washes every lane beneath it so you can see at a glance where each phase begins and ends. Untick it to keep the lanes plain.

The dropdown at the top of the **Stages & steps** tab changes how the row is drawn, for everyone who opens the map:

* **Timeline view** - Stage names sit above a coloured track, with a chip for each step. New Blank journey maps start in this view, as in the image at the top of this article.
* **Classic view** - Each stage is a coloured band with its steps as tiles underneath.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-0eecb477f144ca493c9723ce6543c682e7a2bc25%2Fjourney-maps-structure-09-classic-view-crop.png?alt=media" alt="The Stages and steps row in Classic view. A blue Discover band spans three step tiles, Search for options, Compare accounts, and Read reviews, followed by a yellow Purchase band over Apply online and Verify identity."><figcaption><p>Classic view</p></figcaption></figure>

***

#### How to collapse a stage or a lane

Collapse the parts of a map you're not working on to keep the rest in view.

* **Collapse a stage** - Open the stage's **⋯** menu on the map and click **Collapse stage**, or click the caret beside the stage in the panel. The stage shrinks to a narrow hatched strip across every lane. Hover the strip to see how many steps it holds, and click it to expand the stage again.
* **Collapse a lane** - Click the caret beside the lane's name on the map or in the panel's **Lanes** tab. The lane folds to a thin strip that shows how many cards sit in each column. Click the caret again to expand it.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-0c4366b49462794b81a82c03cc2b159ca6e38664%2Fjourney-maps-structure-12-map-stage-menu-crop.png?alt=media" alt="The menu for the Discover stage open on a journey map, listing Edit structure, Select all cards in stage, Collapse stage, and Delete stage."><figcaption><p>The stage menu on the map</p></figcaption></figure>

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-9e3502a84a3912fba55ab0acea9f663bc206ea96%2Fjourney-maps-structure-15-collapsed-stage-crop.png?alt=media" alt="The Discover stage collapsed to a narrow hatched strip running down through every lane, with a tooltip reading Discover: 3 steps. Click to expand. The Purchase stage and its cards continue to the right."><figcaption><p>A collapsed stage, with its step count on hover</p></figcaption></figure>

Collapsing only changes your own view. Your collapsed stages and lanes stay that way when you come back to the map, but teammates still see everything expanded, and share links and PDF exports always show the full map.

***

#### How to manage lanes from the Structure panel

The **Lanes** tab lists every lane in the map below a locked **Stages & steps** row, so you can tidy up a long map without scrolling it.

* **Rename** - Click the lane's name and type.
* **Recolour or pin** - Hover the row and click the colour swatch or the pin icon. A pinned lane keeps its pin visible and stays in view as you scroll the map.
* **More options** - The **⋮** menu holds **Pin lane**, **Hide lane**, **Jump to lane**, which scrolls the map to that lane, and **Delete lane**.
* **Add a lane** - **+ Add lane** at the bottom adds a Text lane. For other lane types, use **+ Add lane** on the map. See [How to add and manage lanes](https://helpdesk.smaply.app/journey-maps/lanes/how-to-add-and-manage-lanes.md).

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-28073dfee4b6f8a2a2b70a27a0048eaa824cd06d%2Fjourney-maps-structure-19-panel-lanes-pinned-hidden-crop.png?alt=media" alt="The Structure panel on the Lanes tab. A locked Stages and steps row sits at the top, then three lanes: Customer actions with a pin icon, Pain points collapsed, and Opportunities faded and struck through because it is hidden. The Filter button in the toolbar shows a count of 1."><figcaption><p>A pinned lane and a hidden lane in the Lanes tab</p></figcaption></figure>

Hiding a lane works as a lane filter, so only your view changes. The lane is struck through in the panel, and **Filter** in the toolbar shows a count. To bring the lane back, choose **Show lane** from its **⋮** menu or clear the filter. See [How to filter a journey map](https://helpdesk.smaply.app/journey-maps/filtering-and-views/how-to-filter-a-journey-map.md) for how filters behave.

***

#### How to edit several stages, steps, or lanes at once

Tick the checkboxes next to the rows you want in the panel. Ticking a stage ticks all of its steps. A bar appears at the bottom of the screen with the actions for that selection:

* **Steps** - **Select all cards** and **Delete**.
* **Lanes** - **Color**, **Hide**, and **Delete**.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-21ed1d19ef9254bfb8fce9918c40bb5fd2aad8e6%2Fjourney-maps-structure-21-bulk-bar-steps-crop.png?alt=media" alt="A dark bar reading Bulk edit, 2 steps selected, with Select all cards and Delete actions and a close button on the left."><figcaption><p>The bar for two selected steps</p></figcaption></figure>

**Select all cards** selects every card in those steps, ready for the card bulk bar. See [How to bulk edit cards](https://helpdesk.smaply.app/journey-maps/how-to-bulk-edit-cards.md) for what you can do with them.

***

#### How to create a structure on a map without stages

Maps made before structures existed, or built with a Stages lane and stage cards, have no **Stages & steps** row. On these maps the panel shows a **Columns** tab instead, listing each column under the name of the stage card above it. The first time you open one, a **Maps work better with structure** tip may appear under the **Structure** button. **Show me** opens the same tab.

{% stepper %}
{% step %}
**Open the Columns tab**

Click **Structure** in the toolbar. The panel opens on **Columns**.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-f26fc9c06d1e8a26489bde28dee53eea89ea1bfa%2Fjourney-maps-structure-29-unstructured-map-columns-tab-crop.png?alt=media" alt="The Structure panel on a map without stages, showing the Columns tab with a blue Create structure button at the top. Below it, columns are listed by the stage card above them: three Discover &#x26; Apply rows, three Activate &#x26; Onboard rows, and two No stage card rows, with an Add column button at the bottom."><figcaption><p>The Columns tab on a map without stages</p></figcaption></figure>
{% endstep %}

{% step %}
**Click Create structure**

A dialog opens with the lanes Smaply thinks hold your stages and steps already picked.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-e134593c47e8ca3f7101a9f7e4a440ae7ef6945f%2Fjourney-maps-structure-25-create-structure-dialog-crop.png?alt=media" alt="The Create structure from these lanes dialog. The text reads We picked the likely stage and step lanes. Your columns and cards stay the same, and you can undo this any time. A Stages picker shows Stages and a Steps picker shows Steps. An unticked checkbox reads Remove the two lanes selected above. Cancel and Create structure buttons sit at the bottom."><figcaption><p>Create structure from these lanes</p></figcaption></figure>
{% endstep %}

{% step %}
**Check the Stages and Steps lanes**

Each picker lists your Stage and Text lanes. Change either one if the guess is wrong, or pick **None, create new stages** or **None, create new steps** to start fresh.
{% endstep %}

{% step %}
**Decide whether to keep the old lanes**

**Remove the two lanes selected above** is unticked by default, so the original lanes stay on the map. Tick it to remove them and their cards once the structure is built.
{% endstep %}

{% step %}
**Click Create structure**

The **Stages & steps** row appears, with your stages taken from the stage cards and your step names taken from the step lane. Your columns and cards stay where they were. Press `Cmd+Z` (`Ctrl+Z` on Windows) to undo it.
{% endstep %}
{% endstepper %}

***

#### How to go back to regular lanes

If you'd rather manage stages as cards in a lane, open the view dropdown at the top of the **Stages & steps** tab and click **Use regular lanes**. On the map, the **⋮** menu on the **Stages & steps** heading has the same option as **Convert to regular lanes**.

The change happens straight away. Your structure becomes two pinned lanes at the top of the map: **Stages**, with a stage card spanning each stage's steps, and **Steps**, with one text card per column. The column headers come back above them.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-ce87ffb350b8a20820ce13e8453a44e8c90459f5%2Fjourney-maps-structure-23-converted-to-regular-lanes-crop.png?alt=media" alt="A journey map after converting to regular lanes. Column header menus are back above the grid. A pinned Stages lane holds a Discover stage card spanning three columns, and a pinned Steps lane below holds text cards reading Search for options, Compare accounts, and Read reviews."><figcaption><p>The structure as regular Stages and Steps lanes</p></figcaption></figure>

A **Converted to regular lanes** message appears at the bottom of the screen with **Undo**, which restores the structure. To bring it back later, follow [How to create a structure on a map without stages](#how-to-create-a-structure-on-a-map-without-stages).

***

#### Related topics

<table data-column-title-hidden data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-hidden data-card-target data-type="content-ref">Target</th></tr></thead><tbody><tr><td><strong>How to use stage cards</strong></td><td>Label phases with chevron-shaped cards in a Stages lane, the way maps without a structure do it.</td><td><a href="https://helpdesk.smaply.app/journey-maps/cards/how-to-use-stage-cards.md">Stage cards</a></td></tr><tr><td><strong>How to add and manage lanes</strong></td><td>Add any lane type and use the full lane menu on the map.</td><td><a href="https://helpdesk.smaply.app/journey-maps/lanes/how-to-add-and-manage-lanes.md">Add and manage lanes</a></td></tr><tr><td><strong>How to add and manage columns</strong></td><td>Add, move, and delete columns on a map without stages.</td><td><a href="https://helpdesk.smaply.app/journey-maps/lanes/how-to-add-and-manage-columns.md">Add and manage columns</a></td></tr><tr><td><strong>How to bulk edit cards</strong></td><td>Tag, recolour, or delete every card in the steps you selected.</td><td><a href="https://helpdesk.smaply.app/journey-maps/how-to-bulk-edit-cards.md">Bulk edit cards</a></td></tr><tr><td><strong>How to filter a journey map</strong></td><td>Show only the lanes, personas, or tags you need, including lanes you hid.</td><td><a href="https://helpdesk.smaply.app/journey-maps/filtering-and-views/how-to-filter-a-journey-map.md">Filter a map</a></td></tr><tr><td><strong>How to create a journey map</strong></td><td>Start a new map from a blank journey, a template, or Smaply AI.</td><td><a href="https://helpdesk.smaply.app/journey-maps/how-to-create-a-journey-map.md">Create a journey map</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpdesk.smaply.app/journey-maps/how-to-use-the-structure-manager.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
