# Adding a planning item

### Video overview

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2FLFlDcWAT8CelkxQytQQt%2Fadd_a_planning_item_no_audio.mp4?alt=media&token=a8e72901-5b83-49cc-bf6d-3cc183bca4a7>" %}
Adding a planning item from Jira
{% endembed %}

### The flow of adding a planning item&#x20;

#### 1. Select 'Planning' from the Add card menu

If you have planning items available in your plan, you will see the Planning option in the add card menu.&#x20;

<figure><img src="/files/9jmRGx89AHEeUKyAvFzK" alt="" width="375"><figcaption></figcaption></figure>

#### 2. Open the select planning item UI

<figure><img src="/files/xG3HLcAiKzh1rZwmfG98" alt="" width="375"><figcaption></figcaption></figure>

#### 3. Configure at least one integration

Smaply supports adding planning items from multiple tools such as Jira and Azure Devops.  If you don't have any setup yet you will be asked to go and configure at least one before you can proceed

See how to do this

{% content-ref url="/pages/1UFmZNSO8c4cjWEYlFUe" %}
[Planning tools](/integrations/planning-tools.md)
{% endcontent-ref %}

<figure><img src="/files/HENQvWyl3WJXC0Q0J0rL" alt="" width="375"><figcaption></figcaption></figure>

#### 4. Search for an item by summary or ID

When you search, either use its identifier if you know it or by the text in the item summary.

<figure><img src="/files/lmZHpoRXxgJR2VuM7fX8" alt="" width="375"><figcaption><p>Search by text</p></figcaption></figure>

<figure><img src="/files/TSFiL6Q5Zgd4vb2HVfzJ" alt="" width="375"><figcaption><p>Search By ID</p></figcaption></figure>

#### 5. Opening and editing the source item

Either in the toolbar above the card or in the details panel you can open the item and edit it.  Any changes will be reflected back in your journey map

<figure><img src="/files/DFi9tl4bq8Y8KMt0Fa34" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/flWKgTRfKHsakJYbvdw7" alt="" width="375"><figcaption></figcaption></figure>

####


---

# Agent Instructions: 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:

```
GET https://helpdesk.smaply.app/planning-items/adding-a-planning-item.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.