The Embed Popup display format renders a trigger element (typically a button) that, when clicked, opens an oEmbed or URL field’s content inside a lightbox popup. The embed itself is only loaded on click, keeping the initial page load fast.
This format is well-suited to long video embeds, gated previews, and any embedded content that would slow down the page if loaded inline.
Supported Field Types
The Embed Popup display format supports the following field types:
- oEmbed
- URL
Inner Blocks (Trigger)
The visible element visitors click to open the popup is composed of inner blocks placed directly in the editor canvas. When the block is first inserted, it ships with a core/buttons → core/button (“Open”) as the default trigger, but the trigger can be replaced or extended with any blocks — a card, an image, a Group with mixed content, or a plain heading.
How to add or change the trigger
- Click inside the trigger area in the canvas. The block tree highlights the inner-block container.
- Use the standard “+” inserter (or paste/drag a block) to add blocks. The default Button can be deleted or replaced.
- Style each inserted block using its own controls — colors, typography, borders, hover states, etc.
How clicks are wired
The plugin attaches the popup-open behavior to the trigger element automatically — there’s no need to add a custom URL, anchor link, or JavaScript. The whole trigger area is clickable on the front end, regardless of which blocks are inside.
Customization
The Embed Popup display format exposes controls for the trigger, the popup dimensions, the backdrop, and playback behavior.
| Customization | Description | Note |
|---|---|---|
| Keep Aspect Ratio | When enabled, the popup scales from the desktop width while preserving a chosen aspect ratio. | When disabled, Width and Height become per-breakpoint (desktop / tablet / mobile) instead. |
| Aspect Ratio | Aspect ratio of the popup viewport. Options: Landscape 16:9, 4:3, 21:9, 3:2; Square 1:1; Portrait 9:16, 3:4, 2:3. | Only available when Keep Aspect Ratio is enabled. |
| Width | Popup width in any configured CSS unit (px, em, rem, %, vw, vh). | Single value when Keep Aspect Ratio is on; responsive (desktop / tablet / mobile) when off. |
| Height | Popup height in any configured CSS unit. | Only shown (per-breakpoint) when Keep Aspect Ratio is disabled. |
| Autoplay | Starts video embeds (YouTube, Vimeo, etc.) automatically when the popup opens. | Playback counts as user-initiated because the visitor clicked the trigger. |
| Show Close Button | Renders the dedicated close button in the popup corner. When disabled, the popup can still be dismissed via backdrop click or the Escape key. | |
| Backdrop Color | Color of the dimmed overlay shown behind the popup. Defaults to white. | |
| Backdrop Opacity | Opacity of the backdrop overlay, 0–100. Defaults to 70. | |
| Close Button Color | Color of the close button icon. Defaults to white. | Hidden when Show Close Button is disabled. |
The block also supports the following standard WordPress block controls: Block Alignment (including wide and full) and vertical Margin.