Media & Text block

Go back to the list of Blocks

The media & text block allows you to place an image or video side-by-side with text.

To create this layout, click on the block inserter icon to open the block library and select the media & text block.

You can also type /media and hit enter in a new paragraph block to add one quickly:

Slash command to insert the Media & Text block.
Slash command to insert the Media & Text block.

Detailed instructions on adding blocks

Adding content

To add your image or video to the block, you can use the options provided to upload a file from your computer or select from your existing Media library.

How to add content to the Media & Text Block.
How to add content to the Media & Text Block.

To add your text, simply start typing in the text box. You will be given the same text editing options as a regular paragraph block. You can also use the block inserter and add other blocks to the content area.

Block toolbar

In order to reveal the block toolbar, you can click on the block and the toolbar will display. Each block has its own block-specific controls that allow you to manipulate the block right in the editor. The media & text block offers the following options in its toolbar:

Block toolbar for the media & text block.
Block toolbar for the media & text block.

With these options, you can:

Transform the block to a column, group, image (or video if you have a video media file instead of an image ), or cover block.

Transform options for the Media & Text Block.
Transform options for the Media & Text Block.

Toggle the block between a none, wide-width display and a full-width display (if supported by your site’s theme).

Alignment options for the Media & Text block.
Alignment options for the Media & Text block.

You can align your content vertically to either the top, middle, or bottom, using the “Change vertical alignment” option.

Example of "align top" in the change vertical alignment option for the media & text block.
Here the option is selected “Align top”

You can use the following options to show the media content on either the left or right.

Example of "show media on the left" option for the media & text block.
Here the option is selected as “Show media on left”
Example of "show media on the right" option for the media & text block.
Here the option is selected as “Show media on right”

If you attempt to upload a file that is not supported you will receive an error message at the bottom left corner of your browser.

Example error message when uploading an unsupported file type.
Error message example

You can insert a link to the image in the block using the link icon in the Block toolbar. The image can be linked to an external URL or to a page on your site. You can also link the image to its own Media file or Attachment Page.

Adding link to the image in the Media & Text block
Insert link to the image

Use the Replace button in the Block toolbar to replace the media file you have already inserted.

More options

These controls give you the option to copy, duplicate, and edit your block as HTML.

Read about these and other settings.

Block settings

Every block has specific options in the editor sidebar in addition to the options found in the block toolbar. If you do not see the sidebar, simply click the ‘setting’ icon next to the Publish or Update button.

The block settings can be found in the sidebar.

Settings tab

Media & Text block settings

Stack on Mobile

You will be given the option to stack the media and text on top of each other for mobile phones. This is useful for people viewing your website on smaller screens.

If the media and text in your block were to stay side-by-side on mobile, they may be too small to view on mobile devices. By enabling stack on mobile, the content on the left will show on top of the content on the right. This provides a better experience for mobile visitors.

Crop image to fill entire column

If your image does not fit the entire column width, you can turn on this option to automatically crop the image so that it fills the entire column. Additionally, you are given a circular focal point to help center the most relevant section of your photo as it is possible that some cropping may occur.

Alt text ( alternative text)

You can add alt text to the image to describe what the image is about. It is useful for accessibility (screen readers, for example) and for search engine optimization.

Image size

You can choose a full, large, medium, or thumbnail image to display by selecting the size desired from the drop-down menu.

Media width

You can adjust the proportion that the media takes up in the overall percentage of the Media & Text block by adjusting the sliders or typing in the desired proportion. The range is between 15% and 85 %.

Media & Text focal point picker for cropped images

Focal point picker

If you crop the image, you will see the focal point picker. This tool lets you identify the main point of interest in the image and highlight it. Click on the picker to drag it to the spot you want, or use the left and top position percentages below the image to set it manually.

Styles tab


The media & text block provides color settings options to change the text, background, and link colors. Pick a color from the suggestions, or add a custom color using the color picker or by adding a color code.

See this guide for more information about changing colors.


The media & text block provides typography settings to change the font family, appearance, line height, letter spacing, decoration, letter case, and font size.

Get more details about changing typography settings.


The media & text block provides dimension settings options to add padding and margin.

Learn more about dimension controls.


The advanced tab gives you two options. You can add anchor text to be able to link directly to this section of your page. You are also able to add a CSS class to your block, allowing you to write custom CSS and style the block as you see fit.

Advanced settings
The advanced section lets you add a CSS class to your block.


  • Updated 2023-04-03
    • Added information about the focal point picker for cropped images
  • Updated 2022-11-22
    • Aligned images for mobile view
    • replaced redundant content
  • Updated 2022-11-10
    • Removed Color settings and added link to Color overview page
    • Added Dimension and Typography settings and linked to their overview pages
    • Updated a few more screenshots for 6.1.
    • Added info about Insert link in the Block toolbar
  • Updated 2022-11-01
    • Updated video for WP 6.1
    • Updated images to WP 6.1
    • Added image of content locking for Media & Text Block
    • Updated Alt text
    • Added transform option to “Cover”
    • Added error message example
  • Updated 2022-06-02
    • Updated images to WP 6.0Changes to Block Tool Bar
      • Added “None” to alignmentRemoved term “vertically” from alignmentAdded “columns” to transform
      Changes to more
      • Added “Move to”Added “Lock”Added “Hide”
      Updated all instances of “Media + Text” to “Media & Text”
    • Changes to Text & Media block settings
      • Updated color text and background options to include gradients
      • Added “anchor text”
      • Added “cropping images”
      • Added “alt text”
      • Added “image size”
      • Added “media width”
  • Updated 2020-08-23
    • Updated images to WP 5.5
  • Updated 2020-06-04
    • Converted 2 reusable blocks to regular blocks
    • Changes to Headings
    • Changes to Block Toolbar
      • Added Vertical Alignment options
      • Added new images
      • Added “More Options” Block

Was this article helpful? How could it be improved?

First published

Last updated