8. Images

Featured image for Pitchfork Tutorial No. 8: Images.

Adding images is simple in Pitchfork. Get tips for using the Image Block, making images accessible and ensuring they are optimized for the web.

Make your image web-ready

Before you upload an image to your website make sure the image is “web-ready.”

Preparing an image for the web involves optimizing it for fast loading without sacrificing too much quality.

  • Resize the image dimensions to no larger than 1920×1080 pixels.
  • Save at a reduced file size without compromising too much quality. Depending on your photo editor, that might mean
    • low to medium quality
    • 40 to 60% quality.
    • “4” or less in Photoshop.
  • The final photo should be less than 400 kb whenever possible.

Special cases: hero and people images

Hero images

Hero images are the large background images that are in the top-most title section of a page, just below the header. The optimal size for a large hero is 1920×684 pixels. Consider images where the subject appears on the right so the text on the left doesn’t interfere.

Images of people

Typically images of people should be square to fit best in most people-related blocks, like UDS Profile (Manual) or testimonial blocks.

You can use photo editing tools such as Canva to edit the image and make it web-ready.

Upload directly to the media library

  1. Once logged in, click Media on the left-hand side of the dashboard, then click Media Library.
A screenshot of WordPress page with arrows showing the position of media and media library buttons on the dashboard.

2. Once you are in the Media Library, click the Add New button at the top of the page.

A screenshot of WordPress page with an arrow showing the add new media file button on the media library menu.

3. You can either drag and drop the image files you want to upload into the designated area or click the Select Files button to browse your computer and select the image files you want to upload.

4. Once selected, the images will begin uploading automatically.

5. After the image has finished uploading, you can add additional details such as title, caption, alt text, description, and more by clicking on the uploaded image in the Media Library.

Screenshot of a WordPress media upload page with fields for alternative text, title, caption and description, featuring a reminder to add alt text highlighted with an arrow and red text.

Note: Always be sure to add alt text! The alt text is required for accessibility purposes as it describes the content of the image for users who are visually impaired or when the image fails to load. Alt text is required on all image properties on higher ed websites per federal law.

In the page itself in a block

You can add an image in the page by adding it as a block.

  1. Inside the editor, click the + button (“Add block”) in the top-left corner or within the editor area.
A screenshot of WordPress page showing the add block button in the editor area.

2. In the search bar, type “Image” and select the Image block from the options. The Image block will appear in your content area, ready for an image upload.

Screenshot of a WordPress block editor interface showing search results for "image," with icons and options for image, gallery, media & text and other related blocks, marked with red arrows pointing to the "Image" option.

3. Once the Image block is in place, you can add an image in three different ways:

A screenshot of WordPress page showing the image block and highlighting the three options to upload an image.

a. Upload from Your Computer:

  • Click the Upload button.
  • Browse your computer for the image file you want to use and click Open.

b. Select from the Media Library:

  • Click the Media Library button.
  • Choose an image you previously uploaded to your WordPress site.
  • Click Select to insert the image into the block.

c. Insert from a URL:

  • Click the Insert from URL option.
  • Paste the direct URL of the image and press Enter.

After the image has been added, you can customize the image block using Top toolbar and Block editor panel. Make sure to add the alt text.

A screenshot of WordPress page showing the selected image block and highlighting the top toolbar and block editor panel with an arrow pointing to alternative text.