Image Block

Short url:

The Image Block allows you to add an image to your content. After inserting the Image Block, click the Upload button to upload an image to your media library or click the Media Library button to show your media library and select an existing file that you've uploaded previously. Alternatively, click the Insert from URL button to enter the URL of the image you would like to display. You can also drag ’n drop your image onto the Image Block and it will be automatically uploaded to the Media Library and inserted into the Block.

You can add a link to the image using the Insert Link icon (Block Toolbar Insert link) on the Block toolbar. You can link the image to the media file itself, link to the WordPress attachment page for that file, or enter in a custom URL for the link using the provided edit field.

Once you've added your image to your block, there are further options available in the Settings Sidebar.

Alternative Text can be added to your image using the Alt Text field. You can also select a style for your image. Your image will display with square corners by default, but you can also show your image with a rounded mask by selecting the Rounded style. If you select a style in the Default Style dropdown list, any further Image Blocks you add into your page will use that selected style by default.

If you want to change the size of your image, there are a number of ways to do it. You can use the Width and Height fields to set the exact pixel width of your image, or you can use the percentage buttons (e.g. 25%, 50%, 75%, 100%) to change the width accordingly. Alternatively, you can also select the size from the Image size dropdown field. The default WordPress image sizes are available to select (e.g. Thumbnail, Medium, Large or Full Size), and depending on your theme, you may also have other sizes available to you as well.

You can also change the size of the image using the drag handles on the image itself, within the block. Simply position your cursor over one of the blue dots that appears on the edge of the image and then click and drag the image to the size that you want.

When resizing your images, it's always best to only reduce the size, and not enlarge. If you add a small image to your block, and then increase the size, the image will become pixelated and wont appear crisp when viewing your page.

To display a text caption below your image, click in the Write caption… section just below the image and type in your caption.

Basic image editing is also available by clicking the Crop icon (Block Toolbar Crop) on the Block Toolbar. After clicking Crop, you’re provided with three extra icons that allow you to zoom into your image, change the aspect ratio and rotate the image. After making any of these changes, click the Apply button to apply your changes or the Cancel button to cancel the changes.

Image Block