This tutorial is the second in our series about creating & editing pages using the WordPress Blocks editor. It follows on from Part 2: Working with Text Blocks.
What are Attachments?
You may be familiar with “attachments” from email, but WordPress has its own specific definition. In this context, and “attachment” is any type of file you might upload and make available through your page. They might also be generically referred to as “Media”, since they are all uploaded and managed through the Media Library (which you will meet in this tutorial).
An image is the most common type of attachment, but they can also be also PDF files, an MP3 audio files, ZIP archives, or any number of other file types. In this tutorial, “Images” specifically refers to images, but “Files” includes any type of file uploaded to your Media Library.
Adding Image Blocks
So far, we have added various types of text blocks to our content. However, we would have a pretty boring page if we didn’t spice things up with an image or two. Images are a great way to make your page interesting, and communicate the “feel” of your business to visitors.
As always, we’re going to start with the “Add Block” button. This time, We’ll select “Image” from “Common Blocks“.
Right away, we can see that this will be a little more complicated than our text blocks. The empty Image block is a created with a few buttons which allow us to select the image we’d like to place. In almost all cases, we want to click on “Media Library”.
This will open a new, nearly full-screen popup dialogue, which is our WordPress Media Library. Here, we can see all files we have uploaded to our WordPress site. We can also upload new files, which—presuming we have not already uploaded our image—is exactly what we need to do.
The easiest way to upload a file to the Media Library is to open the folder on our computer, then drag the file we want into the Media Library window. If we’re doing it correctly, the window will turn blue when we hold the file over it, and we will see the text “Drop files to upload“.
We release the file, and it begins to upload to our WordPress site. While the upload is in progress, we can see a blue progress bar over the the thumbnail, and in the right-hand side panel.
Providing Attachment Details
Once the upload has completed, we can see the image thumbnail. (It should also be automatically selected, as in the screenshot below.) The right-hand panel now displays “Attachment Details”, with some information automatically taken from our filename.
Before we select the new file, we should provide some descriptive text for these Attachment Details fields. The “Alt Text” field should contain a brief and practical description of the image content, like in our example.
Alt text is very important for images, as it will help vision-impaired visitors understand the content even if they can’t see it. Search engines also use alt text to understand your images, so if you want people to find your page, make sure you provide this info!
The “Title“, “Caption” and “Description” fields are less important, but might still be used by your theme (for example, as thumbnail or lightbox captions). Since we don’t want to write a specific caption for this image, we will just copy the alt text into all fields.
Once we are satisfied with our attachment details, we need only to click the “Select” button, all the way down in the bottom right corner.
This closes the Media Library and populates our Image block with the newly-uploaded image. By default, WordPress has filled the caption area with the text we entered in our attachment details.
Image Block Settings
At this point, our Image block is complete and ready to publish. We can also go on to fine-tune various settings, found in the right-hand “Block” sidebar.
The most common edit after adding an Image block, is changing the Link Settings. By default, nothing will happen when a visitor clicks on your image. (This might change depending on your theme.) However, it’s nice to get a closer look at an image sometimes—most visitors expect that if they click or tap an image, they’ll see it in more detail.
We’d like our visitors to get what they expect, so we’re going to open the “Link Settings” drop-down and select “Media File“. If we want to turn the image into a custom link (for example, if it’s a promotional banner we want to link to another page) we could also set a “Custom URL” instead.
The most common change we need to make after creating an Image block is to change the display size. Naturally, we don’t want to force our visitors to download a full-screen image if we’re only trying to show them a thumbnail!
Fortunately, when we upload an image, WordPress generates multiple copies in a few useful sizes. Each time we add an Image block, we can choose the biggest size we want to make available.
Even if somebody loads our page on a huge screen, they won’t get a bigger version than the one we chose. However, if a visitor comes by on a small screen (like a tablet or smartphone), WordPress will automatically show them a smaller version so they don’t waste bandwidth. This is a great way to make sure your visitors see quality images, without having to wait for big image downloads!
Changing the Caption
When we created our Image block, it automatically filled out the caption based on the information we entered into the Media Library. Every time we use this image, that same caption will be provided for us automatically; we would need to go back to the Media Library if we wanted to update those the Attachment Details.
However, sometimes we might not want to change the attachment details, but we do want a custom caption for a particular Image block. In that case, we could simply type over the automatically-provided caption with whatever text we like.
Image Alignment and Width
Finally, we might want to change how our image is aligned and scaled in relation to other content. By default, no value is set, which means we’re letting the theme use its default value. This usually means centred images.
If we want to make a more specific choice, we can use the Image block toolbar to choose an alignment or width value.
The image is centred in the content area, at the size you have selected. Equivalent to the default on most themes.
The image will stretch to cover an area somewhat wider than the text content, overriding any other size setting you have chosen. This is a very nice choice for important feature images, but it typically has no effect on a page with a sidebar.
The image will stretch to 100% of the page size, overriding any other size setting you have chosen. This type of image make a huge statement, so we should use them sparingly (if at all)! Like Wide alignment, Full is usually overruled on pages where there is a sidebar.
Align Left and Align Right
Left- or right-aligned images will “float” beside other content, allowing text to wrap around them. However, this can sometimes cause unexpected results!
Adding File Blocks
Finally, we might also want to our pages to include attachments which aren’t images. Obviously these can’t be displayed as images, so the File block instead creates a link to the selected attachment.
We’ll begin by choosing the File block from the “Add Block” menu.
Just as we did with images, we have a couple of options for how to upload our media. Once again we will use the Media Library, following the same method detailed for uploading our image. This time, however, we’ll upload a file of another type, such as a PDF.
After uploading and selecting our attachment, we can see the final link appear with a “download” button. Visitors will be able to click the button to download our file.
We have completed our content, so it’s time to publish! We will step through publishing process and set page attributes in Part 4: Page Properties and Publishing.