WordPress.org

Ready to get started?Download WordPress

Codex

Edit Media

Contents

Overview

The Edit Media page is where you manage information about your media that is saved in the Media Library. To reach the Edit Media page, go to Media > Library and click the name of the media item or the Edit link that appears below the name on hover. You can also reach this page by clicking on the Edit link when adding new media to your site.

The data entered on the Edit Media page is often used by attachment pages and galleries if the theme or plugin chooses to display it, and the data is also used as the default values at the time an image is inserted into a page. Once the image has been inserted as an individual image, it becomes disconnected from the data in the media library and you can use the Image Details screen to update it on a per-image basis.

In addition to managing meta data such as title, caption, alt text, and description, there are also added controls for performing basic media edits such as rotating, scaling, and cropping images. For more information see the Edit Image section of this Codex page.

Edit Media Page

Media Edit Screen
Title
The name of the media. A title is displayed in the File column of the Media Library Screen and is often shown on attachment pages and galleries if themes or plugins are designed to display it.
Permalink
This is the URL of the media attachment page. There is also a link to view the attachment page.
Edit Image button
(Image files only) allows you to make edits such as rotate, scale, and crop.
Caption
A brief explanation of the media.
Alternate Text
The alt text for the image, e.g. “The Mona Lisa” to describe the media. Used for accessibility.
Description
An explanation of this particular media.
File URL
Read only display of a direct link to the media file.
Save Meta Box
Displays information about your media, such as the upload date, web address, file name, type, size, and dimensions. Also includes actions to Delete Permanently or Update any change you have made.

More Edit Media Options

Note: The following Meta Boxes may not be visible by default. You can enable them by clicking on the Screen Options tab at the top right of the Edit Media page.

Discussion
Turn the ability to leave comments and/or trackbacks on the media attachment page on or off
Comments
List of current comments saved for this media file
Slug
the attachment page slug
Author
the Author for the media
Developers:  For information about the release of attachment editing, see Attachment editing: now with full post edit UI!

Edit Image

Clicking the Edit Image button launches the image editor sub-panel, giving you access to several useful image editing controls. The edits you make to your image are non-destructive and you can restore the image to it's original (uploaded) specifications at any time. Here are the various controls available to you in this Edit Image mode:

Crop
To crop the image, first click on the image and drag to make your selection. Once a selection has been made, then click the crop icon above the image to finalize the crop. You can use the Aspect ratio and Selection option to make further adjustments or use keyboard shortcuts to fine-tune your crop selection before clicking the crop icon.
Rotate counter-clockwise
rotate the image 90 degrees counter-clockwise.
Rotate clockwise
Rotate the image 90 degrees clockwise.
Flip vertically
Flip the image upside-down.
Flip horizontally
Flip the image left-to-right.
Undo/Redo
Remove or restore your last edit. You can click as many times as you want in succession to "step" through the edit history.
Scale Image
Proportionally scale the original image. For best results, scaling should be done before you crop, flip, or rotate. Images can only be scaled down, not up. The original dimensions are displayed as a guideline above the box for entering new dimensions. Used in combination with the Crop icon, this tool allows you to make the following precise adjustments:
  • Crop Aspect Ratio: You can specify the crop selection aspect ratio then hold down the Shift key while dragging to lock it. The values can be 1:1 (square), 4:3, 16:9, etc. If there is a selection, specifying aspect ratio will set it immediately.
  • Crop Selection: Once started, the selection can be adjusted by entering new values (in pixels). Note that these values are scaled to approximately match the original image dimensions. The minimum selection size equals the thumbnail size as set in the Settings Media Screen.
Restore Original Image 
If changes have been made to an image, the Restore Original Image button allows you to discard any changes and restore the original image. Previously edited copies of the image will not be deleted. Press the Restore image to complete the action.
Save
Use this to save the changes made to an image and return to the Edit Media screen for this image.
Cancel
Use this to cancel any operation that has been performed on the image in the current session.

Keyboard Shortcuts

When cropping your image, these keyboard combinations can 'fine-tune' the size of the crop frame. Note: The arrow key can be any of four arrow keys--up arrow, down arrow, left arrow, or right arrow:

  • Arrow: move by 10px
  • Shift + arrow: move by 1px
  • Ctrl + arrow: resize by 10px
  • Ctrl + Shift + arrow: resize by 1px
  • Shift + drag: lock aspect ratio
See also Administration Screens and Network Admin.