Inserting images into posts and pages (Block Editor) – Documentation – WordPress.org
Skip to content
WordPress.org
Showcase
Plugins
Themes
Hosting
News
Resources
Learn WordPress
Documentation
Education
Forums
Developers
Blocks
Patterns
Photos
Openverse ↗︎
WordPress.tv ↗︎
About
About WordPress
Make WordPress
Events
Five for the Future
Enterprise
Gutenberg ↗︎
Job Board ↗︎
Swag Store ↗︎
Get WordPress
Search in WordPress.org
Get WordPress
WordPress.org
Documentation
Inserting images into posts and pages (Block Editor)
WordPress Overview
Technical Guides
Support Guides
Customization
Get Involved
WordPress Overview
Technical Guides
Support Guides
Customization
Get Involved
HomeSupport guidesMediaInserting images into posts and pages (Block Editor)
Search documentation
Inserting images into posts and pages (Block Editor)
In this article
Table of Contents
Further reading
Changelog
↑ Back to top
Go back to the list of Blocks
Note: This page uses Block Editor. If you are a Classic Editor User, refer this page.
When creating or editing a WordPress page or blog post, you can easily add images to a post or page using the Image Block.
Note: For the most up-to-date and detailed instructions on how to add, edit, and customize images in the Block Editor, please refer to the official Image block guide.
Further reading
Embeds – Inserting different media types.
Gallery – Inserting a gallery block to pages or posts 
Image Size and Quality
Use Images
Use image and file attachments
Settings Media Screen
Media library screen
Media Add New Screen
Edit Media
Inserting Images into Posts and Pages (Classic Editor)
Changelog
Updated: 2026-05-22 (props to @umesh0067, @clk87)
Removed outdated information
Added note to refer to the official Image block guide for up-to-date information.
Updated: 2023-08-08
Updated “More Options” section and added link to the external article.
Updated: 2023-04-14
Updated links.
Replaced Resources with Further reading, added more related links.
Updated: 2020-04-24
Updated the Resource section with Block editor links.
Added to “Common Block” Category
Updated: 2020-04-23
Added the Block Toolbar section
Replaced one animated gifs with newer interface
Replaced three animated Gifs with videos of the current interface (5.4)
Removed the various ways to add a block to a post with the link to the Add a Block page.
Add a Changelog Box
Created: 2019-09-12
Was this article helpful? How could it be improved? Cancel reply
Log in to submit feedback. If you need support with something that wasn't covered by this article, please post your question in the support forums.
First published
September 12, 2019
Last updated
May 21, 2026
Get more help
Support forums
Ask questions in the support forums.
Search
Search
Developers
Check out the developer documentation.
Content suggestions
Report an error or change in the documentation issue tracker.
Get involved
Learn about the Documentation Team and how to contribute.
About
News
Hosting
Privacy
Showcase
Themes
Plugins
Patterns
Learn
Documentation
Developers
WordPress.tv ↗
Get Involved
Events
Donate ↗
Five for the Future
WordPress.com ↗
Matt ↗
bbPress ↗
BuddyPress ↗
WordPress.org
WordPress.org
Visit our X (formerly Twitter) account
Visit our Bluesky account
Visit our Mastodon account
Visit our Threads account
Visit our Facebook page
Visit our Instagram account
Visit our LinkedIn account
Visit our TikTok account
Visit our YouTube channel
Visit our Tumblr account
The WordPress® trademark is the intellectual property of the WordPress Foundation.