How to use planning cards
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.
A planning card puts a work item from a connected planning tool, like a Linear issue or a Jira ticket, directly onto the step it relates to. The card shows the item's own fields and stays in sync with the source, so the map reflects what's actually happening in delivery.
Prerequisites
A planning tool must already be connected at the account level. To connect one, see Integrations > Planning tools (Jira, Asana, Azure DevOps, Linear, Monday.com, and Trello).
To add one, hover an empty cell and click + Add card, then choose Planning. Planning is the Enter quick-select in a Planning lane and sits under ADVANCED CARDS in the picker in any other lane.
How to add a planning item from a connected tool
Planning cards don't hold their own content. Instead, you search a connected tool and pick a live item to display, so the card becomes a window onto that item.
Open the Search planning items modal
Add a planning card. The Search planning items modal opens with a tab for each of your connected tools.
Pick the tool and search
Click the tab for the tool you want, type a query, and click Search. Only the tools connected to your account appear as tabs, so the set you see depends on what's been set up.
Select the item and add it
Choose an item from the results and click Select. The button stays greyed out until a result is selected. The card lands in the slot showing that item's live data.
What a planning card shows
The card displays the source item's own fields, so the layout follows your tool rather than Smaply. A Linear issue, for example, shows its ID, PRIORITY, and STATUS.
To open the item in the tool it came from, select the card and click Open Linear on the toolbar (the label names whichever tool backs the card). The same action sits in the card details panel as Open in Linear.
A planning card has no text-formatting controls, because its content comes from the source item rather than from typing on the card.
What happens when the source item changes or is deleted
A planning item isn't stored in Smaply. The card is a live view of the item in the connected tool, so changes flow one way, from the tool into Smaply.
When the item changes - Edits in the source tool, such as a new status or priority, appear on the card automatically. Most changes are reflected within about 30 seconds.
When the item is deleted - The card can no longer pull its data, because the item it points to no longer exists in the tool. Remove the card from the map to clear it.
There's no Smaply-side copy to edit. To change what the card shows, change the item in the tool.
How the same item can appear on more than one map
Because the item lives in the connected tool and not in Smaply, you can add the same item to as many maps as you like. Each one is a separate card pointing at the same source, and all of them reflect the same upstream status. A status change in the tool updates every card showing that item.
What planning cards share with other cards
Planning cards use the same toolbar tail, card details panel, colour system, and multi-select as every other card type. The card details panel holds the universal Personas, Card tags, and Comments sections.
See How to add and edit cards for the canonical walkthrough of these shared mechanics.
Related topics
Last updated