Images & Videos


All images and documents on a WordPress site are stored in the Media Library.

To upload an image to the Media Library, simply click the “Add Media” button at the top left of the page editor. Note that you must upload the image from your computer. If you simply copy/paste or drag an image over from another site without downloading it to your computer, the image will just be linked from the other site and may fail to display if there is a problem beyond your site.

Make sure the image you select looks good at the size your site will display it.

If an image is displayed at a size too large for its resolution, it can appear pixelated and may be difficult to use.  Also check that your images are not out of proportion (stretched or squished).

If you are using a theme that supports a “featured image”, make sure to use an appropriately sized image.

Although a featured image may simply be an image that appears at the top of a post or page, some themes set featured images as a banner on the page. In this case, make sure the image is large enough to fill the allotted space. These images should be at least 1200 x 700 px.

Align images within your text.

Select an alignment option (left, right or center) when you add the image. This allows the body of your text to wrap around the image instead of being offset by it.

Always include alternative text with any image.

This allows users who are unable to see the screen to get a description of the image. Alternative text is crucial to creating an accessible website.

WordPress actually offers several options for including text metadata with images. In addition to alt text, images may include:

  • a caption to display with the image on the page where it is posted
  • a title to help sort the image within your Media Library
  • a description, which allows you to enter a longer description of the image that will appear as post content on the attachment page

Video Content

Do not upload video content directly to WordPress.

Instead, consider hosting your video from a video sharing site such as Vimeo or Youtube. To embed a video from one of these sites in a WordPress page or blog post, simply paste the URL directly into your text. WordPress will automatically embed the player.  Wordpress does not support <iframe> embeds.

Include transcripts and captions with your video content.

This ensures your videos are accessible to visitors who are unable to hear or see.