Adding images to a WordPress page

Who can use it?

Employees with editor access to a site.


  1. While editing a page or post, place your cursor in the editor where you would like an image to be displayed within the content.
  2. Click "Add Media". A dialogue will appear for inserting media.
  3. If the image already exists in your media library, select the "Media Library" tab to select the image. If you would like to upload a new image, navigate to the "Upload Files" tab.
  4. Once you have uploaded or selected the image you would like to use, an "Attachment Details" pane will appear.
  5. The "Attachment Details" pane provides some basic information about your image in this pane.
    • Title – A descriptive name of the image.
    • Caption – Brief explanation. This text will be displayed below the image.
    • Alt text – This text is required with all images for improved accessibility for those with impaired or low vision who may be using screen readers or other assistive technologies. Use text that makes sense when read out loud along with the context of any text that appears before or after the image on the published page. If the textual context is already present, use the alt text to add information or an additional detail or two about what is actually in the image.
    • Description – You can enter as much information as you want to describe the image.

    The "Attachment Display Settings" pane, located at the bottom of the "Attachment Details" pane, controls how the media embed will be displayed when viewed on the site.

    • Alignment – Use this to tell your image where to appear on the page. You can align Left, Center, Right, or None.
    • Link To – This tells your image how to behave when clicked on by a user. You can link to a media file, an attachment page or a custom URL. Media files and attachment pages will prompt a photo pop-up. Custom URLs will point the user to a different site. If using a custom URL please be sure to use a live link.
    • Size – The size of the image to be displayed on the page.
  6. Once you've modified the fields to your liking be sure to use the "Insert into post" button to add the image into the editor.
  7. Use the "Update" or "Publish" button, located in the "Publish" box.


Article ID: 122
Fri 7/30/21 10:03 AM
Tue 11/16/21 2:18 PM

Related Articles (4)

Create a link to another page or site.
How to edit your website's pages in WordPress.
Embed a video on a page.
How to get login to WordPress Dashboard to begin making changes as a site Editor.