> 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.md).

# Journey Maps

- [Journey maps overview](https://helpdesk.smaply.app/journey-maps/journey-maps.md): Creating, structuring, and evolving journey maps in Smaply
- [How to create a journey map](https://helpdesk.smaply.app/journey-maps/how-to-create-a-journey-map.md): Start a new journey map and build it your way, with Smaply AI, from scratch, or from a template.
- [Cards](https://helpdesk.smaply.app/journey-maps/cards.md): All card types and how to use them in journey maps
- [How to add and edit cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-add-and-edit-cards.md): Add cards to a journey map, edit their content, and use the card details panel to manage tags, personas, and comments.
- [How to use stage cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-stage-cards.md): Label and organise the high-level phases of a customer experience, with each phase spanning the steps it covers.
- [How to use text cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-text-cards.md): Write narrative notes, descriptions, and explanations on a card, then format the text with bold, colour, alignment, lists, and your choice of font.
- [How to use image cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-image-cards.md): Add an image to a journey map, set how it sits in its card, and swap it out whenever you need a different visual.
- [How to use slider cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-slider-cards.md): Score a step on a journey map with one or more sliders, each between two labels you set, for sentiment, satisfaction, or any rating.
- [How to use icon cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-icon-cards.md): Show channels, a checklist, or a set of statuses on a card by picking an icon template and customising its icons, sizing, and layout.
- [How to use embed cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-embed-cards.md): Embed live content from Figma, Google Docs, Sheets, Slides, Miro, YouTube, and other sources onto a journey map by pasting a share link.
- [How to use metric cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-metric-cards.md): Show a live metric, like monthly signups or conversion rate, on a journey map, and set how it displays on each card.
- [How to use planning cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-planning-cards.md): Pull a live work item from a connected planning tool onto a journey map, so the step shows its real status and updates as the work moves.
- [How to use portfolio item cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-portfolio-item-cards.md): Show an opportunity, pain point, solution, or other portfolio item on a journey map, with its scores, priority, status, and assignee in view.
- [How to use linked journey map cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-linked-journey-map-cards.md): Link another journey map onto a card to see its summary and jump to it, and check which maps link to the one you're on.
- [How to use shape cards](https://helpdesk.smaply.app/journey-maps/cards/how-to-use-shape-cards.md): Build a flowchart inside a journey map with square, diamond, circle, triangle, hexagon, and pill shapes joined by arrows.
- [How to comment on a card](https://helpdesk.smaply.app/journey-maps/cards/how-to-comment-on-a-card.md): Discuss any card in context by posting comments from its details panel and @mentioning the teammates you want to pull in.
- [Lanes and columns](https://helpdesk.smaply.app/journey-maps/lanes.md): Lanes (horizontal rows) and columns (vertical structure) form the grid that cards snap to in a journey map
- [How to add and manage lanes](https://helpdesk.smaply.app/journey-maps/lanes/how-to-add-and-manage-lanes.md): Add the horizontal rows that structure a journey map, then rename, recolour, reorder, pin, duplicate, and delete them.
- [How to add and manage columns](https://helpdesk.smaply.app/journey-maps/lanes/how-to-add-and-manage-columns.md): Add, move, and remove the columns of a journey map so its steps line up with the way your experience actually unfolds.
- [How to use emotion chart lanes](https://helpdesk.smaply.app/journey-maps/lanes/how-to-use-emotion-chart-lanes.md): Plot how a persona feels at each step of a journey, label the moments that matter, and reuse a finished chart in other maps.
- [How to use grid lanes](https://helpdesk.smaply.app/journey-maps/lanes/how-to-use-grid-lanes.md): Subdivide a lane into named rows that cross your journey's columns, for tables, channels, or matrix-style content.
- [How to use flow lanes](https://helpdesk.smaply.app/journey-maps/lanes/how-to-use-flow-lanes.md): Map a process in a flow lane by drawing connector arrows between cards, with swimlanes, columns, and lines of interaction for service blueprints.
- [How to use freeform lanes](https://helpdesk.smaply.app/journey-maps/lanes/how-to-use-freeform-lanes.md): Place cards anywhere on an open canvas and connect them with arrows, for whiteboard-style diagrams inside your journey map.
- [How to use divider lanes](https://helpdesk.smaply.app/journey-maps/lanes/how-to-use-divider-lanes.md): Split a journey map into clear sections with a full-width labelled line, useful for service-blueprint lines like Line of Visibility.
- [How to copy lanes across journey maps](https://helpdesk.smaply.app/journey-maps/lanes/how-to-copy-lanes-across-journey-maps.md): Copy a whole lane with its cards and paste it into the same journey map or another one, even in a different workspace or Account.
- [Filters and views](https://helpdesk.smaply.app/journey-maps/filtering-and-views.md): Filter journey map content and save views for quick reuse
- [How to filter a journey map](https://helpdesk.smaply.app/journey-maps/filtering-and-views/how-to-filter-a-journey-map.md): Narrow a journey map to the cards that matter by filtering on lanes, personas, tags, or portfolio items.
- [How to save and apply a view](https://helpdesk.smaply.app/journey-maps/filtering-and-views/how-to-save-and-apply-a-view.md): Save a filter you use often as a named view, then reopen it on the journey map in one click.
- [How to filter and save list views](https://helpdesk.smaply.app/journey-maps/filtering-and-views/how-to-filter-and-save-list-views.md): Filter a workspace list down to the items you care about, then save that filter as a named view you can favorite to your dashboard.
- [How to find cards in a journey map](https://helpdesk.smaply.app/journey-maps/how-to-find-cards-in-a-journey-map.md): Search the cards on a journey map by any word you remember and open the one you need with its details ready.
- [How to bulk edit cards](https://helpdesk.smaply.app/journey-maps/how-to-bulk-edit-cards.md): Select several cards in a journey map at once and tag, recolour, style, assign personas, or delete them in a single action.
- [How to change a card's type](https://helpdesk.smaply.app/journey-maps/how-to-change-a-cards-type.md): Convert a card to a different type in place, keeping its text, colour, personas, card tags, and comments.
- [How to use the structure manager](https://helpdesk.smaply.app/journey-maps/how-to-use-the-structure-manager.md): Organise a journey map into stages and steps from one panel, and fold away the parts you're not working on.
- [How to bulk-edit journey maps in the list](https://helpdesk.smaply.app/journey-maps/how-to-bulk-edit-journey-maps-in-the-list.md): Select several journey maps from the dashboard list at once and tag, archive, or update them all in a single action.
- [How to copy and paste in a journey map](https://helpdesk.smaply.app/journey-maps/how-to-use-enhanced-paste.md): Paste text, tables, and images from other apps into a journey map as cards, and copy cards within a map or into another map.
- [How to use version history](https://helpdesk.smaply.app/journey-maps/how-to-use-version-history.md): Open a journey map's earlier versions, preview any of them, and roll back to one without losing your current work.
- [How to use activity history](https://helpdesk.smaply.app/journey-maps/how-to-use-activity-history.md): See who changed what on a journey map, group and filter the change feed, and highlight unseen changes directly on the canvas.
- [How to lock a journey map](https://helpdesk.smaply.app/journey-maps/how-to-lock-a-journey-map.md): Freeze a journey map so nobody can change it while reviewers read and comment, then unlock it when you're done.
- [How to archive a journey map](https://helpdesk.smaply.app/journey-maps/how-to-archive-a-journey-map.md): Move a journey map out of your active list while keeping it recoverable, with the option to restore it from the workspace Archive section.
- [Journey map keyboard shortcuts](https://helpdesk.smaply.app/journey-maps/journey-map-keyboard-shortcuts.md): Every keyboard shortcut for the journey map editor, with Mac and Windows keys side by side.


---

# 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.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.
