Title: WordPress embed
Author: Birgit Pauli-Haack
Published: May 25, 2020
Last modified: June 9, 2024

---

# WordPress embed

## In this article

 * [Block Toolbar](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#block-toolbar)
 * [Block Settings](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#block-settings)
    - [Media Settings](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#media-settings)
 * [Changelog](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#changelog)

[ Back to top](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#wp--skip-link--target)

[Go back to the list of **Blocks**](https://wordpress.org/documentation/article/blocks/)

With the WordPress Embed block, you can embed WordPress posts into your posts and
pages. You don’t need a WordPress account to be able to use it. You can only embed
public posts, though.

**An Example:**

![Images showing the WordPress embed](https://wordpress.org/documentation/files/
2022/04/155233584-f1b85b8b-fbdb-434c-b950-66a0d407bc3a.png)

**Steps to embed a WordPress Post**

 1. **You need to find the URL of the Post.**

Find the URL of the WordPress post you want to embed in your page. Copy the link
of that post from the search bar.

![Getting the URL for the WordPress embed](https://wordpress.org/documentation/files/
2020/05/second-wordpress-embed.png)

 2. **Go to your post or page**
 3. **Add the WordPress block**

![How to add the WordPress embed to a page or post](https://wordpress.org/documentation/
files/2022/04/155233245-60b63bd9-46d1-4251-9420-029355e70d4b.png)

[Detailed instructions on adding blocks](https://wordpress.org/documentation/article/adding-a-new-block/)

 4. **Paste the link into the text box and click the “Embed” button**

![Image showing how to add the URL for the embed ](https://wordpress.org/documentation/
files/2022/04/155234216-7240c98a-ea04-49d2-b2bd-4b4198802b63.png)

If it’s a link that can be successfully embedded you will see a preview in your 
editor.

![Image showing how to add the URL for the embed ](https://wordpress.org/documentation/
files/2022/04/2022-04-19_11-57-59.png)

If you’re using a link that cannot be embedded, the block shows a message, “_Sorry,
this content could not be embedded._”

You will have two choices: Try again with a different URL or convert it to a link.

![Image showing how to add the URL for the embed ](https://wordpress.org/documentation/
files/2022/04/155235027-68807f45-152e-4a4e-bb9e-94cc1b137ab6.png)

**6. Click on “Preview” to see how it will look on the front-end.**

![Preview of a WordPress embed after adding a URL](https://wordpress.org/documentation/
files/2022/04/155235324-a8004734-1843-4c87-838f-ff49d041cac3.png)

## 󠀁[Block Toolbar](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#block-toolbar)󠁿

Besides the Mover and Drag & Drop Handle, the Block Toolbar for the WordPress embed
shows four buttons:

![Block toolbar for the WordPress embed ](https://wordpress.org/documentation/files/
2022/04/155236019-ba09c31c-890a-4d1f-a488-91327e3568f3.png)

 * Transform to
 * Change alignment
 * Edit URL, and
 * More Options. 

**Transform to**:

![How to transform the WordPress embed to other block](https://wordpress.org/documentation/
files/2022/04/155236194-b9245d2f-62b1-4740-92c8-ae57ff1446d4.png)

You can transform a WordPress embed to a Group. This would give you the ability 
to change the background color around the WordPress embed.

![WordPress embed that has been transformed into a group block](https://wordpress.
org/documentation/files/2022/04/163211830-bba7916b-6d3a-4720-9391-8bad25e4420c-1024x600.
png)

Editor view of an WordPress Embed as a group with Color Settings controls

![The settings available when the WordPress embed is in a group block](https://wordpress.
org/documentation/files/2022/04/163211643-61a84b7b-05a7-4702-9dc1-256c64c5d8dc-1.
png)

WordPress Embed with a green background.

**Change Alignment **

![How to change alignment of the WordPress embed ](https://wordpress.org/documentation/
files/2022/04/163212433-75b0e6e5-0352-47f9-b3c8-afc611d228c1-1.png)

 * **Align left** – Make the WordPress post left aligned
 * **Align center** – Make the WordPress post alignment centered
 * **Align right **– Make the  WordPress post align right

**Edit URL**

Via the edit URL, you can change the WordPress Embed URL in the embed block. Overwrite
the existing URL and click on the “Embed” Button.

![Adding a URL to the WordPress embed ](https://wordpress.org/documentation/files/
2022/04/163212585-09ade742-1afd-4829-a863-8624bcf7b03d.png)

**More Options**

[Read about these and other settings.](https://wordpress.org/documentation/article/more-options/)

## 󠀁[Block Settings](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#block-settings)󠁿

### 󠀁[Media Settings](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#media-settings)󠁿

![Media Settings you can control the behavior of your post embed](https://wordpress.
org/documentation/files/2020/04/Screen-Shot-2020-04-20-at-9.29.46-AM.png)

![](https://wordpress.org/documentation/files/2020/04/Screen-Shot-2020-04-20-at-
9.29.55-AM.png)

Via the _Media Settings_ you can control the behavior of your post embed when viewed
from a smaller device, like on a phone screen.

The Toggle switch turns on or off the resize functionality for smaller devices. 
The default setting is “on” or blue.

**“Off:”** This embed may not preserve its aspect ratio when the browser is resized.
In the off position the toggle switch is gray.

**“On:”** This embed will preserve its aspect ratio when the browser is resized.
The toggle switch turns blue in the “On” position.

**Advanced**

The advanced tab lets you add a CSS class to your block, allowing you to write custom
CSS and style the block as you see fit.

[[

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

## 󠀁[Changelog](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#changelog)󠁿

 * Updated 2022-11-26
    - Removed redundant content
    - Added alt text to images
 * Updated 2022-04-19 – new screenshots
 * Updated 2020-08-18
    - Replaced “More Options” – new screenshot
    - Added “Move To” and “Copy” section under More Options
 * Created 2020-05-25

## Was this article helpful? How could it be improved? 󠀁[Cancel reply](https://wordpress.org/documentation/article/wordpress-embed/?output_format=md#respond)󠁿

[Log in to submit feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fwordpress.org%2Fdocumentation%2Farticle%2Fwordpress-embed%2F&locale=en_US).
If you need support with something that wasn't covered by this article, please post
your question in the [support forums](https://wordpress.org/support/forums/).

First published

May 25, 2020

Last updated

June 9, 2024