Admin / Editor · Allow about 8 minutes

Before you begin

Editor, Admin, or Owner. Use an article image you are allowed to edit. Remove credentials and private information from the source capture before uploading; cropping is not a secure redaction process.

1. Open the image editor

1. Open the article for editing and insert or select its managed image. Use the image’s Edit image control to open the image editor.

2. Identify the single action or screen area the illustration should explain. Keep enough context for the reader to recognise the screen.

3. Use Crop to trim unnecessary surroundings. The managed original remains available, so a crop should never be used to conceal secrets in an uploaded image.

2. Add a small number of annotations

1. Choose Arrow, Border / box, Circle / oval, Highlight, Text, Line, or Draw as appropriate. Use Select to adjust the annotations.

2. Point to the exact control or region mentioned in the written instruction. Avoid covering the label the reader needs to recognise.

3. Keep annotation colours readable and use short text. Explain the action in the article as well; readers should not depend on colour alone.

4. Choose Save edited version and wait for it to finish. Saving image edits and publishing the article are separate steps.

3. Check and publish the image

1. Add descriptive alternative text and a caption explaining what the reader should notice. Preview the illustration at article width and on mobile.

2. Reopen Edit image when you need to adjust the retained editable state. For an edited image, Revert to original is a separate confirmed choice.

3. Publish the article when its text, metadata, and illustration are ready. Editing a published article keeps the existing Reader snapshot until republishing.

4. If an edit fails, keep the current article available, resolve the error, and verify the image before leaving. Do not assume an incomplete save reached the Reader.

Check your result

The article contains a readable annotated image with useful alternative text, while the managed original remains available.

If something goes wrong

• Annotations are too small: simplify the illustration and check it at the actual reading width.

• Sensitive content is in the original upload: remove it at the source and upload a clean capture; cropping or an annotation overlay is not secure redaction.

• Readers see the previous illustration: verify that the edited version saved and the article update was published.

Continue learning

• Write accessible articles and manage media

• Create and publish an article

• Update a published article safely

• Find, reuse, rename, and safely remove files