WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp embed

wp embed <command>

Inspects oEmbed providers, clears embed cache, and more.

In this article

Back to top

GitHub
View Open Issues (1) View Closed Issues (3) Create New Issue

Examples

# Get embed HTML for a given URL.
$ wp embed fetch https://www.youtube.com/watch?v=dQw4w9WgXcQ
&lt;iframe width="525" height="295" src="https://www.youtube.com/embed/dQw4w9WgXcQ?feature=oembed" ...

# Find cache post ID for a given URL.
$ wp embed cache find https://www.youtube.com/watch?v=dQw4w9WgXcQ --width=500
123

# List format,endpoint fields of available providers.
$ wp embed provider list
+------------------------------+-----------------------------------------+
| format                       | endpoint                                |
+------------------------------+-----------------------------------------+
| #https?://youtu\.be/.*#i     | https://www.youtube.com/oembed          |
| #https?://flic\.kr/.*#i      | https://www.flickr.com/services/oembed/ |
| #https?://wordpress\.tv/.*#i | https://wordpress.tv/oembed/            |

# List id,regex,priority fields of available handlers.
$ wp embed handler list --fields=priority,id
+----------+-------------------+
| priority | id                |
+----------+-------------------+
| 10       | youtube_embed_url |
| 9999     | audio             |
| 9999     | video             |
+----------+-------------------+

Subcommands

NameDescription
wp embed cache

Finds, triggers, and deletes oEmbed caches.

wp embed fetch

Attempts to convert a URL into embed HTML.

wp embed handler

Retrieves embed handlers.

wp embed provider

Retrieves oEmbed providers.

Command documentation is regenerated at every release. To add or update an example, please submit a pull request against the corresponding part of the codebase.