# Usage

## Configuration

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

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FVJZVTo3zHPSJpSxh37K9%2Fimage.png?alt=media\&token=411c43e6-9487-4ae9-859b-cbd3a45fc24f)

## Create a new drawing

Click **Add New Drawing**.

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FtIR7gpRTt3MbPlk7TfDp%2Fimage.png?alt=media\&token=a0bfe1bf-7cb7-49ee-a9f9-f20140363f93)

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

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FomLlLgFIh1MAaM52siwu%2Fimage.png?alt=media\&token=632f2f6b-9405-4682-b55b-0a983669cdf3)

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

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FWLuH5EndHKD5uOVK9fde%2Fimage.png?alt=media\&token=e8e41c12-a549-4422-b68a-a528c985c6cc)

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](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2Fb2todHAlmRiSYMDHKQmj%2Fimage.png?alt=media\&token=99162e00-5162-4b84-b101-85deb93da0e0)

## Edit an existing drawing

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

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FJRiapTwcmDmWntctFWSX%2Fimage.png?alt=media\&token=6f8c64a7-5f98-432b-9b36-adfa601cf818)

## Delete an existing drawing

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

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FYQE4l8FfqooyGaO5JLA1%2Fimage.png?alt=media\&token=40e46a9f-6eda-4fc0-b0d9-c2342434246d)

## 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](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2F5chjvvCUkJzsXXmUauFy%2Fimage.png?alt=media\&token=5439546a-56d2-4484-a0de-6933521f9f4b)

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

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2F0No0xR7yMcRCoXXWzpQR%2Fimage.png?alt=media\&token=6c4d6147-6fb2-4de0-9d5a-eec9f710e319)

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FxFvliXvN3gtOng19OA9f%2Fimage.png?alt=media\&token=f394fac1-be22-4542-b65d-a16ed68a4e81)

You can then drag and drop shapes into the canvas.

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FSDW6Vl7gafMalMra2GnI%2Fimage.png?alt=media\&token=a7c504cb-93a6-4988-803b-ce197a2467ed)

## 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](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FhEnDa2ZIpEX1ZljnOrY3%2Fimage.png?alt=media\&token=30a07a0e-7799-46af-bf1d-ee40b969e010)

Add the selected shape to your library.

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2FFGamFCUPr7j87vEmVA7I%2Fimage.png?alt=media\&token=b78f3b8c-7484-481d-93a6-6523f89dea2f)

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

![Excalidraw for Jira](https://3588362646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma7ua4NoSptEMaVrDMS%2Fuploads%2F8AsxLvNgRQkMYk8Ys8Nc%2Fimage.png?alt=media\&token=216af560-24c0-494d-8081-2a0bf248eb9c)