Media

Images »Image Settings

Image settings let you add captions, define alt text and descriptions, and more. 

Attachment Details
Within Posts or Pages
Advanced Options

When you upload an image, you’ll see a number of options to the right side of the media uploader. We’ll walk through what each of these options controls.


Attachment Details

To get to the attachment settings:

  • Go to My Sites → Media
  • Select the image you want
  • Click on Edit.

A window will open up:

  • Edit Image: This button will open a simple editor where you can rotate or crop the image.
  • Title: What the image is called. You can click on the title to edit it.
  • Caption: Enter a caption that will display below the image
  • Alt Text: Controls what text replaces the image in case of slow-loading sites, or for readers using screenreaders and other assistive technology.
  • Description: An optional description of the image that will display on the image’s attachment page (if you choose for the image to be linked to its attachment page).
  • URL: The full direct link to where the image is stored on your site. This cannot be changed.
  • At the bottom, you’ll see some information about your image: the image file name and type, the date the image was uploaded, and the image dimensions.
  • Delete: (on bottom left) Clicking this will allow you to delete the image. This cannot be undone.

The way the caption displays, as well as whether or not the image has a border, is a function of the theme you are using. If you have a plan that allows the use of Custom CSS, you can change the appearance of images using CSS.


↑ Table of Contents ↑

Within Posts and Pages

You can also edit an already-uploaded image directly from the visual editor of a post or page. To do this click on an Image Block.

On the right, you’ll see the image settings you can use to change the image, including the dimensions, links, description, and so on.

For more information on editing images in posts, see this documentation on the Image Block.


↑ Table of Contents ↑

Advanced Options

Finally, there are some Advanced Options available:

The instructions from this guide are referring to the WP Admin editor. You can get to this editor by adding /wp-admin to the end of your site’s url (e.g.: example.wordpress.com/wp-admin


If you are using our Classic Editor and editing posts or pages from within WP-Admin, there are additional Advanced Options available for images.

  • Image Title Attribute controls what will be displayed as a tooltip when a reader hovers over your image.
  • Image CSS Class lets you add CSS classes to an image (this is an advanced option; to get started with CSS, see CSS Basics).
  • Image Border allows you to control the width in pixels and color of a border around your image.
  • Image Margins lets you widen or narrow the amount of space between your image and surrounding content.
  • Open link in a new window/tab will open the image (or the link where the image leads) in a separate browser window or tab.
  • Link Rel controls the image link’s rel attribute, for adding nofollow amongst other things.
  • Link CSS Class lets you add CSS classes to the image link (this is an advanced option; to get started with CSS, see CSS Basics).

Be sure to click the Update button at the bottom-right to apply any changes you make.

Still confused?

Contact support.

Not quite what you're looking for?

Get Help