Embed

The Embed display format renders an oEmbed or URL field as inline embedded media — video players, social-media cards, and any other content WordPress can resolve through its oEmbed pipeline. The embed is fetched server-side and rendered directly in the post.

Because resolution happens through WordPress’s built-in oEmbed system, any URL that core (or another plugin’s oEmbed provider) recognizes will render automatically — no additional configuration is required.

Supported Field Types

The Embed display format supports the following field types:

  • oEmbed
  • URL

Customization

The Embed display format keeps its customization options minimal — the embedded provider supplies the visual content, and the block focuses on fallback behavior and layout.

CustomizationDescriptionNote
Empty MessageToggle (“Show message if empty”) plus fallback text shown when the field has no value or the URL can’t be embedded.Lives in the Output Settings panel.

The block also supports the following standard WordPress block controls: Block Alignment (including wide and full), Border (color and width — radius is disabled because embedded iframes can’t be cleanly rounded), Shadow, and vertical Margin.