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

# Smaply Helpdesk

Help guides for Smaply, covering journey maps, personas, portfolio, research, integrations, and account management.

<h2 align="center">Welcome to Smaply Helpdesk</h2>

<p align="center">Find docs to help answer your Smaply questions</p>

<p align="center"><button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">What do you need help with?</button></p>

<br>

<p align="center">New to Smaply? Take the quick tour.</p>

{% embed url="<https://www.youtube.com/watch?v=pXRQTz-5uak>" %}

<br>

***

### Start here

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4>Get started</h4></td><td>Go from a fresh account to your first journey map, with your team working alongside you.</td><td><a href="/getting-started-with-smaply.md">Getting started</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-0afd1b5f1b393c083d15563018e7718a71177b14%2Fcard-home-get-started.svg?alt=media">card-home-get-started.svg</a></td></tr><tr><td><h4>First steps for admins</h4></td><td>Set up the essentials: branding, roles, users, integrations, tags, and templates.</td><td><a href="/first-steps-for-admins.md">First steps for admins</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-99894d0ba687be63e792e7094f4b6d55104686ed%2Fcard-home-admins.svg?alt=media">card-home-admins.svg</a></td></tr><tr><td><h4>Import your maps</h4></td><td>Bring existing maps into Smaply from Miro, Figma, PowerPoint, or an image.</td><td><a href="/migration/migration.md">Migration overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-4c1b752e302743cf724fb77d840247ab008c056b%2Fcard-home-import.svg?alt=media">card-home-import.svg</a></td></tr><tr><td><h4>What's new</h4></td><td>The latest Smaply features and improvements, newest first.</td><td><a href="/release-notes.md">What's new</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-90d2cd421695754b4266c8941da4fca359f0a8da%2Fcard-home-whats-new.svg?alt=media">card-home-whats-new.svg</a></td></tr></tbody></table>

<br>

***

### Understand your customers

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4>Journey maps</h4></td><td>Create, structure, and evolve journey maps with lanes, columns, and every card type.</td><td><a href="/journey-maps/journey-maps.md">Journey maps overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-a12bc56bb1f6484e24f5a3f40ba7ffea8f42ebe9%2Fcard-jm-create-soft.svg?alt=media">card-jm-create-soft.svg</a></td></tr><tr><td><h4>Research hub</h4></td><td>Run investigations, analyze transcripts with AI, and turn raw research into insights.</td><td><a href="/research-hub/research-hub.md">Research Hub overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-3f2bb3d032f7d78c01065ef70176fac1763c3245%2Fcard-home-research-hub.svg?alt=media">card-home-research-hub.svg</a></td></tr><tr><td><h4>Personas</h4></td><td>Build customer personas and assign them to the journey map cards they shape.</td><td><a href="/personas/personas.md">Personas overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-de5e4dc8a6bdabf5d98e15fb30d7b6e49bc4e191%2Fcard-home-personas.svg?alt=media">card-home-personas.svg</a></td></tr></tbody></table>

<br>

***

### Improve customer experience

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4>Portfolio</h4></td><td>Capture pain points, opportunities, and solutions, then prioritize them across journeys.</td><td><a href="/portfolio/portfolio.md">Portfolio overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-3be67fe1c0076b3bc79d36d9c5abe727c17c6210%2Fcard-home-portfolio.svg?alt=media">card-home-portfolio.svg</a></td></tr><tr><td><h4>Metrics</h4></td><td>Put live quantitative data on your journey maps as charts and numbers.</td><td><a href="/metrics/metrics.md">Metrics overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-d0658468808d21b322ce90526b522cac6504c2bb%2Fcard-home-metrics.svg?alt=media">card-home-metrics.svg</a></td></tr><tr><td><h4>Hierarchy maps</h4></td><td>Connect related journey maps into a navigable map of maps.</td><td><a href="/hierarchy-maps/hierarchy-maps.md">Hierarchy maps overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-2ee91ba61889b5e62930768eb0a1be91386e0700%2Fcard-home-hierarchy-maps.svg?alt=media">card-home-hierarchy-maps.svg</a></td></tr></tbody></table>

<br>

***

### Connect your tools

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4>Metric integrations</h4></td><td>Pull data from Google Analytics, Power BI, Qualtrics, Excel, and Google Sheets.</td><td><a href="/integrations/metrics-tools.md">Metrics tools</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-7ad37fc9b7108f31b58ef02aa8e5336c71d331fc%2Fcard-home-metric-integrations.svg?alt=media">card-home-metric-integrations.svg</a></td></tr><tr><td><h4>Planning integrations</h4></td><td>Link work items from Jira, Asana, Linear, Monday.com, Trello, and Azure DevOps.</td><td><a href="/integrations/planning-tools.md">Planning tools</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-9bb6ac7febb1455bec1a660992e726edb548c1a2%2Fcard-home-planning-integrations.svg?alt=media">card-home-planning-integrations.svg</a></td></tr><tr><td><h4>Embeds</h4></td><td>Embed Figma, Miro, Google Docs, YouTube, and more directly on a card.</td><td><a href="/journey-maps/cards/how-to-use-embed-cards.md">Embed cards</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-14efa89b71d21bd7310bf0063f1173b2e7f4ad65%2Fcard-home-embeds.svg?alt=media">card-home-embeds.svg</a></td></tr></tbody></table>

<br>

***

### Collaborate with your team

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4>Sharing and exporting</h4></td><td>Share a read-only link, share a saved view, or export a map to PDF.</td><td><a href="/sharing-and-exporting/sharing-and-exporting.md">Sharing and exporting overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-f83da584b92eaeff4625d15e6dbaae33867d305c%2Fcard-home-sharing.svg?alt=media">card-home-sharing.svg</a></td></tr><tr><td><h4>Account and team</h4></td><td>Manage users, roles, workspaces, tags, branding, billing, and plans.</td><td><a href="/account-and-team/account-and-team.md">Account and team overview</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-beb203244e0a34559b35b1b5a23f6cbd50b9c111%2Fcard-home-account-team.svg?alt=media">card-home-account-team.svg</a></td></tr><tr><td><h4>Invite users</h4></td><td>Add teammates at the account, workspace, or journey map level.</td><td><a href="/account-and-team/users-and-roles/how-to-invite-users.md">Invite users</a></td><td><a href="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-477941bad7f5b1a07a66e21102100aa811f87443%2Fcard-home-invite-users.svg?alt=media">card-home-invite-users.svg</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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpdesk.smaply.app/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
