> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bowerlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Image Annotations & Diagrams

> Draw on images and create diagrams with arrows, shapes, text, and freehand marks.

Bower includes a built-in drawing editor powered by Excalidraw. Use it to:

* **Annotate images** — draw on existing images to highlight, label, or mark up
* **Create diagrams** — build flowcharts, sketches, and system diagrams from scratch

Annotations and diagrams are saved as a separate layer so you can edit them later without losing the original.

## Annotating inline images

1. Click an image in the note editor to select it.
2. In the floating toolbar that appears, click the **draw icon** (Annotate).
3. The full-screen annotation editor opens with your image as the background.
4. Draw your annotations, then click **Save**.
5. The annotated preview replaces the inline image immediately.

To edit existing annotations, click the image and tap the draw icon again. Your previous drawings will be loaded so you can modify them.

## Annotating image attachments

1. Open an image attachment (from the Artifacts list or a note's attachments).
2. Click the **Annotate** button in the header bar, or find it in the **more options** (three-dot) menu.
3. Draw your annotations and click **Save**.
4. The attachment preview updates to show your annotations.

## Creating diagrams

1. In the note editor, type `/diagram` (or find "Diagram" in the slash command menu), or click the **draw icon** in the fixed toolbar above the editor.
2. The full-screen drawing editor opens with a blank canvas.
3. Draw your diagram using shapes, arrows, text, and freehand tools.
4. Click **Save** — the diagram appears as an inline image in your note.

To edit an existing diagram, click it and tap the **draw icon** in the floating toolbar. Your previous drawing will be loaded so you can modify it.

## Drawing tools

The annotation editor provides a full set of drawing tools:

| Tool      | Shortcut | Description                 |
| --------- | -------- | --------------------------- |
| Selection | V or 1   | Select and move elements    |
| Hand      | H        | Pan the canvas              |
| Rectangle | R or 2   | Draw rectangles and squares |
| Diamond   | D or 3   | Draw diamond shapes         |
| Ellipse   | O or 4   | Draw circles and ellipses   |
| Arrow     | A or 5   | Draw arrows                 |
| Line      | L or 6   | Draw straight lines         |
| Draw      | P or 7   | Freehand drawing            |
| Text      | T or 8   | Add text labels             |
| Image     | 9        | Insert additional images    |
| Eraser    | E or 0   | Erase elements              |

## Styling annotations

When you select a shape, style controls appear on the left side of the editor:

* **Stroke colour** — change the outline colour
* **Background colour** — fill the shape
* **Stroke width** — thin, regular, or bold
* **Stroke style** — solid, dashed, or dotted
* **Opacity** — make elements semi-transparent
* **Edge style** — sharp or rounded corners

## Science shape libraries

When you open the diagram editor, a curated set of scientific shape libraries is automatically loaded into the **Library** panel (book icon, top-right). These include pre-made shapes you can drag onto the canvas:

| Library              | What's included                                                   |
| -------------------- | ----------------------------------------------------------------- |
| Biology              | Cell structures, organelles, organisms, lab diagrams              |
| Medicine             | Anatomical structures, medical symbols and stencils               |
| Mathematical Symbols | Common math notation designed for the Excalidraw hand-drawn style |
| Circuit Components   | Resistors, capacitors, logic gates, wiring diagram elements       |
| Data Science         | Tool icons for Jupyter, Pandas, NumPy, TensorFlow, and more       |
| Deep Learning        | Neural network layers — CNN, RNN, LSTM, Transformer blocks        |

To use a library shape, open the Library panel, find the shape you want, and click it to place it on the canvas. You can resize and style it like any other element.

## Saving and exporting

* **Save** — stores your annotations and updates the image preview. The original image is preserved and can be restored.
* **Export** (download icon) — downloads a flattened PNG with your annotations baked into the image.
* **Cancel** (X icon) — if you have unsaved changes, you'll be asked to confirm before discarding.

## Copying annotated images and diagrams

When you duplicate an annotated image or diagram using the **copy** button in the floating toolbar:

* A new independent copy is created
* Annotations or diagram content are copied to the new version
* You can edit either copy without affecting the other

## Tips

* The original image is never modified — annotations are a separate overlay
* Annotations are preserved when you reload the page
* Use **Cmd+Z** to undo and **Cmd+Shift+Z** to redo while drawing
* Hold **Shift** while drawing to constrain shapes to squares/circles
* Double-click text to edit it
* The lightbox (click to zoom) shows the annotated version of images
* Images with transparent backgrounds (PNGs) preserve their transparency
* Annotated images are visible on [publicly shared pages](/organisation/sharing-artifacts)

## Limitations

* Only one person can annotate an image at a time
* Only image files can be annotated (not PDFs, audio, or other file types)