All topics

Guide

Oxygen 6 OEmbed: A hosted tutorial video beside written steps

A hosted tutorial video beside written steps. Learn when to use OEmbed, follow a practical setup, and diagnose common problems.

2 min read · Updated 30 September 2026

Editorial review: builder-first workflow. Practice example; frontend behavior still needs checking in your project.

What it does and when to use it

Embed supported hosted content by providing its URL. This example focuses on one achievable outcome rather than listing every possible setting.

Before you start

Start with a test page and the data or assets described in the example. The values below are starting points, not universal design defaults.

Worked example: A hosted tutorial video beside written steps

Scenario: A hosted tutorial video beside written steps. The goal is a useful result on a real project, not a claim that this scenario was a completed client project.

  1. Choose a public URL from a provider supported by WordPress embedding.
  2. Add OEmbed and enter that URL through its content controls. Add written steps and a normal fallback link below it.
  3. Use its parent Container to keep the embed within the article width.
  4. Preview logged out and on a phone. For a direct media-file URL, use HTML5 Video rather than assuming the provider accepts it.

Expected result

You should have a hosted tutorial video beside written steps. Verify the result on the frontend using the same content or object described in the steps. A correct builder preview alone does not establish that links, data or interactions work for visitors.

Troubleshooting

If the embed is blank, confirm that WordPress and this Oxygen element support the provider. Use HTML5 Video for a direct video file rather than assuming every URL is embeddable.

Checks before publishing

Support depends on WordPress providers and Oxygen’s implementation. The Oxygen reference notes this control may be limited to video sources.

  • Compare desktop and narrow-screen layouts using actual content.
  • Follow every destination and operate interactive controls with a keyboard where applicable.
  • Check an empty or unavailable-data state when the element depends on a provider.

Official reference and version notes

Official OEmbed reference provides the current provider information. This is independent, AI-assisted documentation on Benjamin Olsen’s website; examples are clearly identified as practice recipes.

The native references were checked against the site’s Oxygen 6.2.0-beta.9 installation and public documentation. Individual recipes should still be validated in your project.

Need more help with this guide? Contact Benjamin →

Explore more topics