The image block can be added to a page by clicking on the Add Block button.

Detailed instructions on adding blocks can be found here.

Adding an Image

The media options panel will load with the options, Upload and Media Library.

Upload and Media Library will let you add or choose media from your library and embed it in your page. More information about image editing is available on our Photo Editing page.

Resizing Images

Once the image is added to the editor, you can resize and align the images to better fit the surrounding content.

In order to resize an image, click on the image to reveal the draggable resize handles. Then, click on the resize handles and drag the image to your desired size.

Alternatively, on the right hand side in the block settings, the image size can be fine tuned by adjusting width and height dimensions. There are also some convenient options in the block settings for setting the image to 100, 75, 50, and 25% of its original size.

Aligning Images 

If you wish to align an image within a paragraph you will first need to insert the image just above the target paragraph block.

From there, click on the image and select left or right alignment, this will merge the image into the paragraph block and the text will float around.

Wide and Full Width Images 

Wide and Full-Width images will allow you to expand the image beyond the theme’s usual content width.


If you wish to add a caption to a singular instance of an image, simply type it in the caption space below the image in the editor.

The link settings allow you to hyperlink your images. You may choose to click on the image to open an attachment page, the original media file, or a custom URL of your choice.

Block Settings 

Every block has specific options in the editor sidebar in addition to the options found in the block toolbar.

Alternative Text

To aid visitors using screen readers, every photo that adds meaning to the page should be given concise meaningful Alt Text. Alt Text should briefly convey the contextualized message of the photo. Ensuring the meaning of images is conveyed via Alt Text aligns with the Americans With Disabilities Act.

This phrase or sentence only needs to be a short phrase that conveys the message of the photo in its context. It should not duplicate nearby document text. Images that do not convey meaning and are purely decorative should be left blank. The W3C has produced a decision tree to help you decide if an image is truly and purely decorative or has meaning.

Learn more about what you need to do to ensure your website’s accessibility on our Accessibility page.

Aspect Ratio

You can choose to display your image image at a different ratio than the one you uploaded. It will crop into your image to create the desired ratio.


You can also manually set your image’s pixel width and height. It is best practice to only set one value and let the other be “Auto”, otherwise you could squish your image.


When you upload your image we go ahead and generate several additional sizes in case you’d like to avoid photo editing altogether. If you have taken the time to edit your photos, choose Full Size. If you uploaded a sufficiently large image but it still looks fuzzy, check to see if you aren’t using a smaller size than you intended. Also, if your image is smaller than one of the generated sizes the larger version won’t be created.

Thumbnail: 170px x 170px square
Medium: 300px on the long side
Large: 1024px on the long side
Full Size: Your original uploaded image

Expand on Click

This toggle in the editor panel will open the image into a lightbox when a user clicks it. It should load the Full Size version of your image. We’ve enabled Expand on Click on all the images on this page so you can see that in action.