Images and media

Images can be dragged into a document, pasted from the clipboard, or added from the / menu. What happens to them afterwards is worth understanding, because it is the part that decides whether your published page keeps working.

Where images live while you are writing

An image you add is uploaded to Workover’s own storage and referenced from the document. It is private: only people who can open the document can load it. A share link carries the same access, so a reviewer sees the images; someone guessing a URL does not.

What happens when you publish

On the way to WordPress, any image the site does not already have is uploaded into your WordPress media library, and the body is rewritten to point at the copy there.

That matters more than it sounds:

The published page does not depend on Workover being reachable.
Disconnecting Workover later does not break your images.
The images are in your media library, where the rest of your site’s tooling can see them.

You do not have to do anything for this — it happens on push.

Alt text

Set alt text on the image. It travels with the image to WordPress and lands on the attachment, so it is set once rather than re-typed in wp-admin.

An image with no alt text still publishes. It is just worse, for the obvious reasons.

Sizes and layout

Resize by dragging the handles, and use alignment to place an image left, centre or full-width. WordPress receives the alignment as block markup, so the published page matches what you laid out.

Very large images are worth resizing before upload — Workover will not downscale a 12MB screenshot for you, and your readers will download all of it.

Featured image

The featured image is separate from the images in the body: it is a WordPress field, set in the WP panel rather than in the text. Upload one there or pick from the media library.

Downloading everything

A document’s images can be downloaded as a zip with their real filenames, from the document menu. Useful when handing a piece to someone who needs the assets, or when moving a site.