Images »Image Settings

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

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

At the top of your page, you’ll see the Title of the image. You can click on the title to edit it.


Next, on the right side of the page, there is a Caption field, where you can enter a caption to display below your image.

Note: 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 the Custom Design upgrade, you can change the appearance of images using CSS.

The Alt Text field controls what text replaces the image in case of slow-loading sites, or for readers using screenreaders and other assistive technology.

Description is 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).

Below this, you’ll see the image URL, which is 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.

At the bottom left, you’ll see a Delete link in case you would like to delete the image.

↑ Table of Contents ↑

Within Posts

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 in the Visual Editor. You’ll see a popup appear where you can edit the alignment, the size, and the caption, or remove the image from the post or page.


Alignment lets you choose for your image to be left- or right-aligned, with your text wrapping around it, or center-aligned with the text breaking above and below it. You can also choose ‘None.’

↑ 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.:

Note: These advanced options only appear when you edit an image directly from a post or page.

Edit Post ‹ My Pretty Blog — WordPress-3

  • 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).

Note: Be sure to click the blue 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