# Draw and shape in the editor

The editor's tools, the Pen and point editing, turning, grouping and clipping, page size and margins, with every tool's key.

The web editor has a rail of tools for drawing a master from a blank page. This page covers each tool, drawing and reshaping with the Pen, turning, grouping and clipping, the page, and the key for each. For opening a size or master to change it, see [Edit a size or master in the browser](https://withmestra.com/docs/how-to/edit-in-the-browser/). For pictures, type and fills, see [Pictures, type and fills in the editor](https://withmestra.com/docs/how-to/editor-pictures-type-fills/). To work without a mouse, see [Use the editor from the keyboard](https://withmestra.com/docs/how-to/editor-keyboard/).

> **Before you start:**
>
> - You need the **Editor** or **Owner** role.
> - The tools show only when you design a master, or start a design from a blank page. A size has no tools. In a size you move, resize and re-word what is there. See [Edit a size or master in the browser](https://withmestra.com/docs/how-to/edit-in-the-browser/).
> - On a phone, the tools sit in a row above the bottom bar.

## The tools

Pick a tool from the **Tools** rail, or press its key. Each button's title shows its key. **Esc** puts the tool down.

| Tool          | Key     | What it makes                                                                                                |
| ------------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| **Select**    | V       | Nothing. It selects, moves and resizes what is there.                                                        |
| **Text**      | T       | A text. A click makes a one-line text; a drag makes a box. The word "Text" is selected, so you type over it. |
| **Rectangle** | R       | A rectangle with square corners.                                                                             |
| **Ellipse**   | O       | An ellipse.                                                                                                  |
| **Line**      | L       | A straight line from where you press to where you let go.                                                    |
| **Polygon**   | Y       | A regular polygon, with six sides to start.                                                                  |
| **Star**      | S       | A star, with five points to start.                                                                           |
| **Pen**       | P       | A path you draw point by point. See [Draw with the Pen](#draw-with-the-pen).                                 |
| **Picture**   | I       | A picture. You choose it from the picture chooser, or upload one.                                            |
| **Frame**     | F       | A picture frame with an outline. The picture fills it and is clipped to the outline.                         |
| **Logo**      | Shift+L | Your brand's primary logo, in its own proportions, inside the safe area.                                     |
| **Button**    | B       | A pill with a label on it, grouped. The label takes the **Button** role.                                     |

How a tool places something:

- **Drag** on the page to draw the box. Hold **Shift** to keep the sides equal. A Line held with **Shift** snaps to steps of 45 degrees.
- **Click** to place the tool's default size, centred where you clicked. The default is a share of the page's shorter side, so a tall page and a wide page get the same-sized thing. It stays inside the page, or inside the safe area when the size has one.
- **Press Enter** on the artwork with a tool picked to place the default at the page's centre. Each Enter after that steps the next one along.
- A **Logo** always goes inside the safe area.

Things to know about particular tools:

- A new **Line** is drawn in your brand's first colour. Change it, and add arrowheads or other ends, under **Stroke** and **Line ends** in the **Appearance** section.
- For a **Polygon** or **Star**, change **Sides**, **Points** and **Inner size** under **Appearance**, then **Shape**. An outline that is neither a regular polygon nor a star shows "This outline isn't a regular polygon or star, so it has no sides or points to change." with **Remake as polygon** and **Remake as star**.
- While the **Frame** tool is picked, a **Frame outline** row offers **Rectangle**, **Rounded rectangle**, **Ellipse**, **Polygon** and **Star**. The next frame you draw has that outline.
- A **Button**'s label is coloured from your palette to read well on the pill.
- If a tool is refused, the editor says so and "Nothing was added."

### Position and align

Select an element to set its **X**, **Y**, **Width** and **Height** in the **Position** section. The nine-point **Reference point** says which part of the element the numbers describe. The align row has **Align left**, **Align centre**, **Align right**, **Align top**, **Align middle** and **Align bottom**, each **to safe area**, **to the artwork** or **to the selection**. Select three or more and **Space evenly across** and **Space evenly down** appear. A group selected whole is moved, aligned and spread as one thing.

If the brand holds an element to a range of sizes, the field says so, for example "The brand holds this between 80% and 120% of its size."

## Draw with the Pen

The Pen draws a path: straight segments, curves, open lines and closed shapes.

1. Press **P**, or choose **Pen**.
2. Click for a corner point. Press and drag for a smooth point; the handle follows the pointer, and the handle on the other side mirrors it.
3. Hold **Shift** to hold a segment, or a handle, to steps of 45 degrees. Hold **Alt** while dragging to let one handle go alone and make a sharp turn.
4. To close the path, click the first point. Dragging from the first point pulls its handles, for a smooth close.
5. To leave a path open, select **Done**, or press **Shift+Enter** or **Esc**. **Cancel** drops it.

A path needs at least two points to stay open, or three to close. A path drawn wholly off the page is refused: "The path is wholly off the page. Draw at least part of it on the page." Part of it may run off the page.

A new path with no fill is drawn as a line in your brand's first colour. Give it a fill and a stroke in **Appearance**.

### Draw with the keyboard

You don't need a pointer. With the Pen picked:

- The arrow keys move a cursor. **Shift** moves it ten steps.
- **Enter** puts a corner point on the cursor. With no cursor move yet it goes at the page's centre.
- **Enter** on the first point of a path of three or more points closes it.
- **Backspace** takes the last point back.
- **Shift+Enter** finishes an open path of two points or more. **Esc** does the same, clears a path of fewer points, or puts the tool down if there are none.

A screen reader hears each point ("Point 3 at 210, 101"), "Path closed" and "Path added".

## Edit a path's points

Select a path and choose **Edit points**, or press **Enter**. A rectangle, ellipse, line, polygon or star shows **Edit shape** instead. See [Edit shape](#edit-shape) below.

1. Click a point to select it. **Shift**-click adds or removes points from the selection, and a drag across empty paper selects the points inside it.
2. Drag a point to move it, or drag its handles to reshape the curve. **Shift** holds a handle to 45 degree steps. **Alt** breaks a smooth pair so the two handles move alone.
3. Click on the outline between points to add a point there. The curve doesn't change. Drag at the same time to place it.
4. Use the buttons over the stage: **Delete**, **Corner** or **Smooth**, **Open** or **Close**, and **Done**. Double-click a point to switch it between corner and smooth.

A closed path needs at least three points and an open one two. **Delete** that would leave too few does nothing. A picture frame's outline stays closed, so **Open** is off for it.

From the keyboard:

- **Tab** goes to the next point, **Shift+Tab** back. **Cmd or Ctrl+A** selects every point.
- The arrow keys move the selected points; **Shift** moves them ten steps.
- **H** takes the point's handles in turn, so the arrows move a handle.
- **+**, **=** or **Insert** adds a point after the selected one. **S** smooths or sharpens it. **O** opens or closes the path.
- **Delete** or **Backspace** removes the selected points.
- **Enter** finishes. **Esc** puts back a drag, then finishes.

### Edit shape

**Edit shape** turns a rectangle, ellipse, line, polygon or star into a path with the outline it has, so you can move its points. A rounded rectangle's corners become curves, and an ellipse becomes four points. The fill, stroke, look and a picture frame's picture stay as they were.

Some shapes have no plain outline to turn into, so **Edit shape** is refused: "That shape can't be turned into a path without changing how it looks: a bevelled, inset or fancy corner, an arc or ring, or a stroke of a different weight on each side has no plain outline." Remove the bevel, arc or uneven stroke first.

## Turn and flip

Select an element and drag the **Turn** handle above it. **Shift** snaps the angle to steps of 15 degrees. Or type in the **Angle** field in **Position**. Angles run counter-clockwise, so a positive angle turns the element to the left. The field shows the allowed range if you go past it.

- A group has no angle of its own. Its field reads **Turn by**, and turns every member by what you type.
- A button turns as one piece, pill and label together.
- Only a text, a shape, a picture or a vector can be turned.
- Some things can't be turned, and the editor says why: a photo ("Give it another role to turn it"), the background, a picture drawn from a design app, something that moves as one with what it sits with, a text with pinned line breaks, and a group that has its own fade, look, or another group inside it that isn't a clip.

**Flip horizontal** and **Flip vertical** are in the **Picture** section, under **Flip**. A master's picture can be mirrored; a size's can't, and a logo isn't offered it.

## Group and clip

**Group** (**Cmd or Ctrl+G**) ties the selection together. **Ungroup** (**Shift+Cmd or Ctrl+G**) undoes it. **Bring forward**, **Send backward**, **Bring to front** and **Send to back** change the stacking order; **Cmd or Ctrl+]** and **Cmd or Ctrl+\[** do the first two, and **Alt** with them goes all the way. **Layers** shows each group as "Group of N".

A **clip** crops things to a shape.

1. Select the shape and what it should clip: two or more things.
2. Choose **Clip to shape**, or press **Alt+Cmd or Ctrl+M**.
3. The shape becomes the frame. It shows in **Layers** as a "Clip group of N", with a **Frame** row.
4. To undo it, select the clip group and choose **Release clip**, or press **Shift+Alt+Cmd or Ctrl+M**.

The frame has to be a closed shape: a rectangle with plain corners, an ellipse, a polygon or star, a closed path from the Pen, or a picture frame. Text, lines, open paths and cut or inset corners can't be one: "A clip needs a closed shape for its frame". So draw a closed path with the Pen and use it as a clip, or use **Edit shape** and reshape a rectangle first.

If **Clip to shape** is greyed out, hover it to read why. Typical reasons: you selected only one thing, one of them is in a group already, none is a closed shape, or one is the background. **Ungroup** is off for a clip group; release the clip first.

A picture can also be placed straight into a shape. Select the shape and choose **Place picture…**, or drop a picture file on it. The picture fills the shape and is clipped to its outline.

## Set the page size and margins

Select nothing, in a master, and the inspector shows **Page**: **Page width**, **Page height** and the four margins, in the master's unit (px or mm). Change one field and press **Enter** or leave it. Each field is its own undo step.

- Changing the page doesn't move or scale anything on it.
- A page can be only so big or small on a side. The editor says the range if you go outside it.
- A margin has to be between 0 and a limit it shows. The margins can't leave no page: "Left and right must add up to less than the width, and top and bottom to less than the height."

## Hide and delete

In a master, **Delete** removes the selected element. In a size, use **Hide** instead: press **Shift+Cmd or Ctrl+H**, or use the hide button on the layer in **Layers**. With nothing selected, the same keys bring back what you hid.

## How your design apps carry these

When you save a master back to a design app, each app keeps some things as live design objects and shows others as a picture, so the design still looks right. Here is how the features on this page fare.

| Feature                                      | InDesign           | Figma | Canva              |
| -------------------------------------------- | ------------------ | ----- | ------------------ |
| Pen paths: open lines and curves             | Kept               | Kept  | Kept               |
| Paths made of several shapes, and fill rules | Kept               | Kept  | Shown as a picture |
| Turning                                      | Kept               | Kept  | Kept               |
| Clip to shape                                | Kept               | Kept  | Shown as a picture |
| A clip's own stroke                          | Shown as a picture | Kept  | Shown as a picture |

For pictures, type and fills, see [How your design apps carry these](https://withmestra.com/docs/how-to/editor-pictures-type-fills/#how-your-design-apps-carry-these).

## If something goes wrong

| You see                                                                 | What to do                                                                     |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| "The path is wholly off the page."                                      | Draw at least part of the path on the page.                                    |
| "The path was not kept: new shapes can't be added just now."            | Try again in a moment.                                                         |
| "That can't be turned." or a reason                                     | Read the reason. See [Turn and flip](#turn-and-flip).                          |
| "That can't be made a clip. Try again."                                 | Select the shape and the things to clip again.                                 |
| "That shape can't be turned into a path without changing how it looks…" | Remove the bevelled corners, arc or uneven stroke, then choose **Edit shape**. |

## What's next

- [Pictures, type and fills in the editor](https://withmestra.com/docs/how-to/editor-pictures-type-fills/)
- [Use the editor from the keyboard](https://withmestra.com/docs/how-to/editor-keyboard/)
- [Edit a size or master in the browser](https://withmestra.com/docs/how-to/edit-in-the-browser/)
- [Start a design in Mestra](https://withmestra.com/docs/how-to/start-a-design/)
