Title: oEmbed Field
Published: February 20, 2025
Last modified: June 6, 2026

---

# oEmbed Field

## In this article

 * [Key Features](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/oembed/?output_format=md#key-features)
 * [Settings](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/oembed/?output_format=md#settings)
 * [Availability](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/oembed/?output_format=md#availability)

[ Back to top](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/oembed/?output_format=md#wp--skip-link--target)

The oEmbed field allows embedding external content from various providers like YouTube,
Vimeo, and Twitter. It automatically handles the embedding process using WordPress’s
oEmbed functionality.

## 󠀁[Key Features](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/oembed/?output_format=md#key-features)󠁿

 * Support for multiple providers
 * Automatic embed handling
 * Preview capability
 * Width/height control
 * WordPress oEmbed integration

## 󠀁[Settings](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/oembed/?output_format=md#settings)󠁿

 * Width – Maximum width of embedded content
 * Height – Maximum height of embedded content
 * Preview Size – Display size in admin

## 󠀁[Availability](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/oembed/?output_format=md#availability)󠁿

The live URL preview and search (which resolves a pasted URL into embed HTML on 
the fly) uses WordPress’s registered oEmbed provider allowlist for anonymous visitors
and users without the standard WordPress content-authoring capability (`edit_posts`).
Users with content-authoring capability can also use WordPress oEmbed discovery.
Already-stored oEmbed values continue to render normally for all viewers regardless
of login state.

First published

February 20, 2025

Last updated

June 6, 2026

Edit article

[ Improve it on GitHub: oEmbed Field ](https://github.com/wordpress/secure-custom-fields/edit/trunk/docs/features/field/oembed/index.md)

Changelog

[ See list of changes: oEmbed Field ](https://github.com/wordpress/secure-custom-fields/commits/trunk/docs/features/field/oembed/index.md)

[  Previous: Using the Number Field](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/number/number-tutorial/)

[  Next: Using the oEmbed Field](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/oembed/oembed-tutorial/)