# 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.

## Related

- [Editor basics](/docs/editor-basics)
- [Pushing a document to WordPress](/docs/pushing-to-wordpress)
- [Images are missing after publishing](/docs/images-not-appearing)