> Updated for version 6.0.30

To explain a graph to your team, you can now put arrows, frames, sticky notes and numbered steps right on it, without touching the story. These annotations are for commenting, dividing and documenting: the player never sees them.

![Annotated graph: titled section frame, numbered steps, sticky note and arrows behind the blocks](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbmdKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--20cec4ab03f6f1c2dac4e2c882a01da6b0c34652/graph-annotations--canvas-formes.en.png)
*an annotated graph, with a titled section frame, a yellow sticky note, a numbered step "1" and an arrow linking two blocks*

## What shapes are for

A shape is not a block. It is drawn **behind** the blocks (shapes under groups, arrows under blocks) and it is not included in the build or in exports: the published game, the debugger and the translations do not see it.

For example, you can:

- wrap a chapter in a **Section frame** and give it a title;
- add a **Sticky note** to leave an instruction for a colleague;
- number the main stages of a path with **Numbered step** badges;
- link blocks or shapes with an **Arrow** to show a sequence.

## Where to find shapes

Right-click an empty area of the graph. The menu offers, in this order: **Add block**, **Comment**, **Shapes**. Click **Shapes**: the list of shapes opens, and the new shape is placed where you clicked (snapped to the grid).

![Shapes list opened from the right-click Shapes entry: Arrow, Section frame, Rectangle, Ellipse, Diamond, Sticky note, Numbered step, Brace, Freehand drawing, Pixel art, SVG image](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbmtKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--6d2ae68c866e40181fabfe04e849f611c77f904e/graph-context-menus--annotations-menu.en.png)
*the right-click menu on the graph, with the "Shapes" entry and its list open*

> 🔺 **Note:** this entry used to be called "Annotations". If you are looking for "Comment", that is a real block of the graph: see [⬜ Comment](https://documentation.celestory.io/hc/celestorydoc/articles/fr-blocs-commentaire-511219).

## Available shapes

| Shape | What you get |
|---|---|
| **Arrow** | A loose 250-pixel arrow, ready to be attached |
| **Section frame** | A frame with a title ("Section" by default) |
| **Rectangle** | A rectangle with text in the middle |
| **Ellipse** | An ellipse with text in the middle |
| **Diamond** | A diamond with text in the middle, handy for a question |
| **Sticky note** | A yellow note, text starting at the top left corner |
| **Numbered step** | A numbered badge (the next number is suggested) |
| **Curly brace** | A brace to group several elements |

The list also offers **Freehand drawing**, **Pixel art** and **SVG image…**: they are covered in [Drawing on the graph: freehand, pixel art and SVG images](https://documentation.celestory.io/hc/celestorydoc/articles/1795347821-drawing-on-the-graph-freehand-pixel-art-and-svg-images).

A shape can be moved and resized like a block. It cannot be smaller than 100 by 75 (50 by 50 for a numbered step).

## Linking with arrows

An arrow can start from a block or a shape and end on a block or a shape. There are two ways to link it.

### Drag the ends

1. Add an **Arrow**: it appears loose, attached to nothing.
2. Drag one of its ends (the **Anchor point: drag to link**) onto a block or a shape.
3. Do the same with the other end.

### Use "Link to…"

1. Right-click a block or a shape.
2. Choose **Link to…**.
3. Click the block or shape to link to. A message reminds you: "Click the block or shape to link to. Esc to cancel."

An arrow follows its blocks when you move them. If you delete a block or a shape, the arrows attached to it are deleted with it, in the same action: a single undo brings them back.

### Reverse the direction

Right-click the arrow and choose **Reverse the arrow**.

## Editing a shape

Right-click the shape or the arrow, then choose **Edit the annotation**. An editing window opens.

![Shape editor windows for a section, a sticky note (Text field) and a step, with Fill color and Outline color](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbm9KIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--27118f287e45071c79fd7755c0bd63a827521841/graph-annotations--editeur-forme.en.png)
*the "Shape editor" window of a sticky note, showing Text, Fill color and Outline color*

For an **arrow** ("Arrow editor"):

- **Label**: a short text on the arrow;
- **Line**: **Straight**, **Curved** or **Elbow**;
- **Heads**: **One head** or **Two heads**;
- **Thickness**: **Thin**, **Medium** or **Thick**;
- **Color**.

For a **shape** ("Shape editor"):

- **Text**, or **Title** for a section frame, or **Number** for a numbered step;
- **Fill color**;
- **Outline color**.

## Let the AI assistant annotate the graph

The AI assistant in Graph mode can add, link and remove arrows and shapes (frames, sticky notes, steps, drawings). For example, ask: "Wrap the introduction in a frame titled Start and number the three steps". See [The AI assistant that builds your graph](https://documentation.celestory.io/hc/celestorydoc/articles/fr-generation-ia-l-assistant-ia-qui-construit-votre-graphe-c079a4).

## Good to know

- Shapes are not blocks: they do not count in block statistics, and the debugger does not check them.
- When you move a group of blocks, the shapes inside its frame follow it, and so do the arrows attached to its blocks.
- A graph created before this feature opens normally, with no shapes.

## See also

- [Detailed Tutorial: The Graph Interface](https://documentation.celestory.io/hc/celestorydoc/articles/en-discover-celestory-the-graph-interface-visual-scripting-9acdb8)
- [Drawing on the graph: freehand, pixel art and SVG images](https://documentation.celestory.io/hc/celestorydoc/articles/1795347821-drawing-on-the-graph-freehand-pixel-art-and-svg-images)
- [Tidying your project: modules, graphs and links](https://documentation.celestory.io/hc/celestorydoc/articles/1795349636-tidying-your-project-modules-graphs-and-links)
- [🗯 Group blocks](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-groupez-des-blocs-58c55c)
