Editing an image
This page explains the image editor of the Admin 4 design. It opens from the image field of the edit form. For what the editor is and how a site switches it on, see The image editor.
Open the editor
- Edit an item that has an image field, for example an Image from the media library.
- Next to the stored image, press Edit image. If the field has no image yet and the site accepts SVG, New SVG drawing starts an empty drawing instead.
The editor opens in a window over the form: the file name and size at the top, the toolbar, the image in the middle, the settings of the current tool on the right, and Cancel and Save at the bottom.
The toolbar: undo and redo, zoom, crop, rotate, flip, resize, brightness, contrast, black and white, sepia, pixelate, blur and watermark.
The tools for photos and other raster images
Every tool has a label, a keyboard shortcut (shown in its tooltip) and a panel with its settings. Each change is shown on the image at once and becomes a step with Apply, so you can undo it.
| Tool | Key | What it does |
|---|---|---|
| Crop | C | Drag on the image, or type X, Y, width and height. The ratio is Free, Original, a ratio of the site's image sizes, or one of 1:1, 4:3, 3:2 and 16:9. |
| Rotate left, right | [ and ] | Rotates by 90 degrees. |
| Rotate by an angle | A | A free angle, with a background color for the corners. |
| Flip | H and V | Flips horizontally or vertically. |
| Resize | S | Width and height, with Keep proportions. |
| Brightness, contrast | B and K | For the selection or the whole image. |
| Black and white, sepia | G and E | For the selection or the whole image. |
| Pixelate, blur | P and U | For a region, for example a face or a number plate. |
| Watermark | W | A text in a color and opacity you choose, or an image the site offers. See Adding custom watermarks. |
Resize (shortcut S) changes the width and height of the image.
Undo is Ctrl+Z (⌘+Z on a Mac), redo Ctrl+Shift+Z or Ctrl+Y. The keys + and - zoom, 0 fits the image to the window. The arrow keys move a crop selection. The shortcuts work while the cursor is not in a field.
Each tool has a keyboard shortcut, shown in its tooltip; A rotates by a free angle.
Drawings (SVG)
An SVG image opens in the drawing editor. Its tools are select (V), rectangle (R), ellipse (E), line (L), path (P), freehand (F) and text (T), with fill, stroke, stroke width, opacity, font and font size, delete, duplicate (Ctrl+D), bring to front and send to back. With the focus on the drawing, N and Shift+N select the next and previous object, the arrow keys move it, and Enter adds a shape of the current tool in the middle, so you can draw without a mouse.
Save or cancel
- Save stores the result as the image of your draft. The form shows the new image without reloading. Publish the draft to show it on the site.
- Cancel or Escape asks whether to discard your changes, and leaves the draft as it was.
The classic admin designs
In the classic admin designs, the editor is ezie. It opens from the image field as well, with the tools select, crop, flip, rotate, watermark, contrast, brightness, pixelate, black and white and sepia in its Actions window. Save & Close stores the edited image in your draft; Quit asks before it throws your changes away.
What can go wrong
- A shortcut does nothing. The cursor is in a field of the panel. Click the image, or use the buttons.
- Save is refused. The message in the status line says why: the image is too large, its type may not be stored, or the draft is not yours.
- Text in a drawing looks different elsewhere. A font that is not installed on the reader's computer is replaced. If your site configures fonts, tick Save text in added fonts as paths before saving.
Read more
- Images, media and uploads, in the help center.
- Images and files
Contributors
- Ricardo Correia
- Graham Brookins Updated Maintainer
Comments
Add a comment