Codex tools: Log in
When creating or editing a WordPress page or post, you can easily embed many different types of media at any time using the WordPress Add Media tool.
Embeddable media include:
The following will take you step by step through the process of embedding media into your content.
In order to embed media in your page or post content, you must first insert your cursor in the place in the text where you want the media to appear. By placing your cursor within your text, you can embed media inline with your content. You can also place your cursor on a blank line if you want the media to appear by itself.
Tip: It’s a good idea to place your cursor on the left margin of your text, even if you want media to appear on the right. This is because there is a special setting called Alignment that allows you to control whether the image appears on the right or the left side of the text. It even automatically controls how text flows around media embeds.
Once you’ve placed your cursor on the line where you want your media to appear, click on the Add Media button to launch the media uploader interface, then select the Insert Media option from the list of actions in the left side of the media uploader window.
You can upload or select the media you want to add to your page or post by choosing from either of the following options in the center of the media uploader window:
Once you have selected or uploaded the media you want to add, Yyou will see a checkbox next to the thumbnail confirming your selection, and see information about it displayed in the Attachment Details pane on the right hand side of the media uploader interface.
The Attachment Details pane displays a small un-cropped thumbnail or preview of the media item, as well as important information such as the filename, date uploaded, and dimensions in pixels.
For images, there are also action links that allow you to Edit Image, which takes you to the Edit Media page, or to Delete Permanently to remove the image from your site.
In addition, you can edit the following media information:
For more information on these media settings, see the Edit Media page.
The Attachment Display Settings pane controls how the media embed will be displayed when viewed on the site.
You have options to set how you would like the media aligned on the page (in relation to the text and margins) and what the link behavior of the image will be, For images, you can set what size image you would like to display on your page.
The Alignment setting allows you to determine where you would like the image to appear in your content area and how it interacts with any text on the page. You have the following image alignment options to choose from:
|Top row: Left and Right alignments. Bottom row: Center and "None" alignments|
The Link To settings determine the URL/web address to which the image will be linked when clicked on by a visitor to your site. You can specify the following image link settings:
The Size settings determine the size of the image you are adding to your site. By default WordPress creates a range of four image size for you to choose from:
|Thumbnail, Medium, and Large image sizes (Image Alignment: Left)|
You can visit the Settings>Media section of your WordPress dashboard to customize the above image sizes.
Once you have determined your embed settings, click on the blue Insert Into Post or Insert Into Page button, to add the media to your page or post. After the media uploader window closes, you will see the media embed in the text editor window.
(This applies to images only, video/audio embeds are shortcodes.)
At any time, you can edit a media embed's settings by first selecting the embed in the Visual Editor, then clicking the clicking on the Edit Image button in the upper left hand corner. You can remove the image from your page/post by clicking on the Remove Image button.