Clear CMS Docs 2026

Editing a photo

Crop, turn, brighten or reshape a photo, put words on it, and choose the part that always stays in view. Saving never overwrites the original.

On this page

The photo editor changes how a photo looks: crop and turn it, fix its light and colour, give it a look, cut it to a shape, put words on it, and choose the part that must always stay in view. Saving never overwrites anything: each save is a new version, and the original photo is kept.

Open it

  • In Media: double-click a photo, or select it and press Enter.
  • On a page, in the page editor: click the photo, then the pen (Edit photo) on its bar.
  • In a record, like a news story or a team member: point at the photo and press Edit.

From a page or a record, the editor opens on the Focal point tool, the one you need most there.

The photo editor: the tools above the photo, Save at the top, the photo's details and where it is used on the right

The tools

Click a tool in the bar above the photo, or press its letter. Esc closes the tool.

Tool Key What it does
Crop and turn C Crop to a shape (Free, Original, 1:1, 4:3, 16:9, 3:4, 9:16, 2:3, or the shape a card uses), turn left or right, flip, and Straighten. In Free, hold Shift to keep the shape. Guides help you line things up.
Adjust light and colour A Exposure, brightness, contrast, highlights, shadows, saturation, warmth, tint and blur. Double-click a slider to put it back.
Effects and looks E Ready looks (Natural, Warm, Cool, Mono, Vintage, Punch), a vignette (darker edges), and film effects: black and white, sepia, fade and grain.
Cut to a shape S Rounded corners, a circle, an ellipse, a hexagon, an arch, a star, a heart or a blob. Outside the shape is see-through, so a JPEG photo saves as PNG.
Focal point F Click or drag to the part that must stay in view, like a face. Wherever the photo is cut to fit, on a card or a phone screen, that part stays.
Text and images T Put words, or another photo from Media such as a logo, on top. Drag to move, pull a corner to resize. Text has a font, size, colour, a box behind it and a shadow.
Crop and turn: pick a shape, turn, flip or straighten

At the top, Undo and Redo step through your changes. Hold the split-square button (Hold to see the original) to compare, and Start over drops every change.

Save

Press Save, or its arrow for the other ways:

  • Save: a new version of the photo. Nothing is overwritten.
  • Save as new photo: a separate file in Media, beside this one, with "-edited" in its name.
  • Bake into source…: this version, at full size, becomes the photo every new edit starts from. The old source is kept, and pages keep the versions they show.

The focal point is kept with the photo itself, so every card and thumbnail that shows it keeps that part in view.

Where the new version shows

The Used on list beside the photo shows each place that uses it, with a small preview of how it will look there:

  • The place you opened the editor from always takes the save (it says Editing).
  • Opened from Media, the save becomes the version Media shows (Media (default)). Each other place says whether it Takes this save or Keeps its version.
  • Opened from a page or a record, only that page or record takes it.

The line under the list says how many places the save reaches.

The side panel

Beside the photo you can also change its Name and Alt text, see its size and where it is used, and add Tags, as in Media. Opened from Media, the top bar also copies the photo's link, downloads it or deletes it. The arrows at the far right make the editor fill the screen.

  • An SVG drawing (like a logo) stays sharp: cropping, turning, flipping, shapes and size keep it a drawing, and Colours swaps its colours. Light and colour, effects and text save it as a PNG picture instead, and the panel says so.
  • PDFs and videos cannot be edited here, only their name and alt text.
Last updated October 23, 2026