In short: In the Classic Editor, click Add Media. In the block editor, add an Image block. Upload a file or pick one from your Media Library, add alt text, then save your post. Compress large photos before you upload.
Tip: Big photo straight from a camera or phone? Shrink it first. See Compressing images for web.
Classic Editor
- Click in the text where you want the image to go.
- Click Add Media above the toolbar.
- Choose Upload Files to add a new image, or Media Library to reuse one you have uploaded before.
- Select the image. On the right, fill in Alternative Text.
- Under Attachment Display Settings, choose an alignment and a size.
- Click Insert into post.
To change the image later, click it in the editor and use the small toolbar that appears. The pencil icon opens the size and alt text settings.
Block editor
- Click the + button where you want the image to go, or type
/imageon an empty line and press Enter. - In the Image block, click Upload to add a new image, or Media Library to reuse one.
- With the image selected, open the settings sidebar (the panel icon at the top right). On the Content tab, fill in Alternative text.
- Use the block toolbar above the image to change its alignment, or drag its corner handles to resize it.
Tip: To add several images at once, use a Gallery block instead.
The image is part of your post, so remember to save: Publish or Update in the Classic Editor, Publish or Save in the block editor.
Good to know
- Alt text describes the image for people who use screen readers or cannot load images. Say what the image shows and why it matters, in a sentence. If it is purely decorative, tick Mark as decorative (block editor) or leave the field empty (Classic Editor).
- Uploaded images live in Media in your Dashboard. Deleting an image from a post does not delete it from the Media Library.
- Want more detail? See wordpress.org’s guides for the Image block and the Classic Editor.