> For the complete documentation index, see [llms.txt](https://fulstech.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fulstech.gitbook.io/docs/whiteboarding-and-diagramming/excalidraw-for-jira/jira-cloud/usage.md).

# Usage

## Configuration

Enable the **Excalidraw** panel on the issue page.

![Excalidraw for Jira](/files/yTecve2VH8Sbbut1zmMH)

## Create a new drawing

Click **Add New Drawing**.

![Excalidraw for Jira](/files/L7Rwg1meiOSdPtGUjBLu)

Provide **Drawing name**, and draw some diagrams.

![Excalidraw for Jira](/files/3l7VJjvLMvOTlXznecfx)

Draw anything you want. To draw perfect shapes like a circle, hold the **Shift** button while drawing.

![Excalidraw for Jira](/files/rb3ivGyEOSPii62dfNAj)

Click **Save and Close** to save the drawing and go back to the issue.

The drawings are stored as an attachment named `do-not-delete-excalidraw.json`. This file should not be deleted or modified manually. 

If you also want to export the drawing as an issue attachment, click **Save and Attach Image**. If the attachment does not appear, please refresh the issue page.

![Excalidraw for JIra](/files/aAV96SwWILVZjRxlucwp)

## Edit an existing drawing

To edit, click the thumbnail in the **Excalidraw** panel. Find the **Edit** button in the menu.

![Excalidraw for Jira](/files/VInZtrK1j1BQV3zs0YCz)

## Delete an existing drawing

Find the **Delete** button in the menu. At this moment the deletion is permanent.

![Excalidraw for Jira](/files/hFwl8YNr9bklJgCMmhYr)

## Adding new shapes from the Excalidraw Libraries website

The Excalidraw Libraries website (<https://libraries.excalidraw.com>) provides a lot of useful shapes. These shapes are contributed by the community.

To add new shapes, visit the website and click the **Download** button to save the collection you need to your computer. The downloaded library file's extension is `.excalidrawlib`.

> **Do not use the Add to Excalidraw button, as the library will not be added to the plugin-hosted Excalidraw Editor.**

![Excalidraw for Jira](/files/wVLhlA4dNrZFaKchpDLe)

Open the Excalidraw Editor in Jira, and upload the library file.

![Excalidraw for Jira](/files/bEzAJJXNYTPUV0fQx0kt)

![Excalidraw for Jira](/files/76AQkGP0PN0dyT05oNef)

You can then drag and drop shapes into the canvas.

![Excalidraw for Jira](/files/c5384M9NFMf8HMn4ewFq)

## Saving shapes as libraries

Let's say we want to save the following doughnut shape to reuse later. The first step is to select the whole shape.

![Excalidraw for Jira](/files/R1Wvw357a01xn89zzHaQ)

Add the selected shape to your library.

![Excalidraw for Jira](/files/w7Pb8MiovrEC9HnenYNL)

To save your library locally (for the backup purpose, for example), click the **Export** button.

![Excalidraw for Jira](/files/ob16pCbiETEEGNqymbNQ)


---

# 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://fulstech.gitbook.io/docs/whiteboarding-and-diagramming/excalidraw-for-jira/jira-cloud/usage.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.