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

# Manually edit BPMN elements on the Just Flow It canvas

> Drag, resize, rename, and connect BPMN elements directly on the canvas — manual editing is available on all plans including Free.

While the AI handles the heavy lifting of diagram generation and restructuring, sometimes you need precise, hands-on control. Just Flow It's canvas lets you drag elements to new positions, rename them in place, add or remove connections, change element types, and resize pools and lanes — all without leaving the editor. Manual editing works alongside AI generation: generate a strong first draft with AI, then fine-tune the details yourself.

## The element palette

The left sidebar contains the full BPMN 2.0 element palette. It's organized into groups — events, tasks, gateways, data objects, pools, lanes, and connecting objects — so you can quickly find what you need.

To add an element to the canvas, click and drag it from the palette and drop it anywhere on the canvas. The element is created with a default label that you can edit immediately. Alternatively, you can double-click an empty area of the canvas to get a quick-add menu with the most common elements.

<Tip>
  Combine AI generation with manual touch-ups for the best results. Let the AI sketch out the overall structure and flow, then use the palette and canvas controls to add specialized elements — like data stores, boundary events, or compensation activities — that benefit from precise placement.
</Tip>

## Canvas interactions

<CardGroup cols={2}>
  <Card title="Move elements" icon="arrows-up-down-left-right">
    Click and drag any element to reposition it on the canvas. Hold <kbd>Shift</kbd> and click multiple elements to select and move them as a group.
  </Card>

  <Card title="Rename elements" icon="pen-to-square">
    Double-click any element label to enter edit mode and type a new name. Press <kbd>Enter</kbd> or click outside the label to confirm.
  </Card>

  <Card title="Add connections" icon="arrow-right-arrow-left">
    Hover over a source element until the connection handles (small arrows) appear on its edges. Drag from a handle to the target element to create a sequence flow, message flow, or association.
  </Card>

  <Card title="Delete elements or connections" icon="trash">
    Select an element or connection and press <kbd>Delete</kbd> (or <kbd>Backspace</kbd>) to remove it. Deleting an element also removes its attached connections.
  </Card>

  <Card title="Resize pools and lanes" icon="left-right">
    Click a pool or lane to select it, then drag the resize handles on its edges to expand or contract it. Other elements inside the container shift to stay within the new boundaries.
  </Card>

  <Card title="Change element type" icon="right-left">
    Right-click any element to open the context menu, then choose **Change type** to swap it for a different BPMN element — for example, converting a task to a subprocess, or an intermediate event to a boundary event.
  </Card>
</CardGroup>

## Right-click context menu

Right-clicking any element or connection on the canvas opens a context menu with the most common actions for that element type:

* **Rename** — opens the label for inline editing
* **Change type** — swap the element for another BPMN shape
* **Add lane** — (pools only) inserts a new lane inside the selected pool
* **Delete** — removes the element and its connections
* **Copy / Paste** — duplicate elements within the same diagram
* **Edit properties** — open the properties panel to set documentation, markers, and other BPMN attributes

## Selecting multiple elements

Click and drag on an empty area of the canvas to draw a selection rectangle around multiple elements. Once selected, you can:

* Move the entire group by dragging any element in the selection
* Delete all selected elements at once with <kbd>Delete</kbd>
* Copy and paste the group with <kbd>Ctrl</kbd>+<kbd>C</kbd> / <kbd>Ctrl</kbd>+<kbd>V</kbd> (or <kbd>Cmd</kbd>+<kbd>C</kbd> / <kbd>Cmd</kbd>+<kbd>V</kbd> on Mac)

<Note>
  Manual editing is available on **all plans**, including Free. There are no feature restrictions on canvas interactions regardless of your subscription tier.
</Note>

## Keyboard shortcuts

| Action                | Windows / Linux                               | macOS                                        |
| --------------------- | --------------------------------------------- | -------------------------------------------- |
| Select all            | <kbd>Ctrl</kbd>+<kbd>A</kbd>                  | <kbd>Cmd</kbd>+<kbd>A</kbd>                  |
| Copy                  | <kbd>Ctrl</kbd>+<kbd>C</kbd>                  | <kbd>Cmd</kbd>+<kbd>C</kbd>                  |
| Paste                 | <kbd>Ctrl</kbd>+<kbd>V</kbd>                  | <kbd>Cmd</kbd>+<kbd>V</kbd>                  |
| Undo                  | <kbd>Ctrl</kbd>+<kbd>Z</kbd>                  | <kbd>Cmd</kbd>+<kbd>Z</kbd>                  |
| Redo                  | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd> | <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd> |
| Delete selected       | <kbd>Delete</kbd> or <kbd>Backspace</kbd>     | <kbd>Delete</kbd> or <kbd>Backspace</kbd>    |
| Zoom in               | <kbd>Ctrl</kbd>+<kbd>+</kbd>                  | <kbd>Cmd</kbd>+<kbd>+</kbd>                  |
| Zoom out              | <kbd>Ctrl</kbd>+<kbd>−</kbd>                  | <kbd>Cmd</kbd>+<kbd>−</kbd>                  |
| Fit diagram to screen | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>H</kbd> | <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>H</kbd> |
