Skip to main content


The oEmbed field creates a simple text input for entering a media URL. This field offers a live preview of the media content. It supports many media websites.



Besides the common settings, this field has the following specific settings, the keys are for use with code:

Size of the input boxsizeSize of the input box. Without this setting, the input box is full-width
Not available textnot_available_stringThe text message is displayed to users when the embed media is not available. Accepts HTML.

This is a sample field settings array when creating this field with code:

'id' => 'oembed',
'name' => 'oEmbed(s)',
'type' => 'oembed',


This field saves the media URL to the database.

Template usage

Displaying the embedded media:

<h3>Youtube video</h3>
<?php rwmb_the_value( 'my_field_id' ) ?>

Getting the URL:

$url = rwmb_get_value( 'my_field_id' );
echo $url;



To change the message for all oembed field when no embed is available:

add_filter( 'rwmb_oembed_not_available_string', function( $message ) {
$message = 'Sorry, what you are looking here is not available.';
return $message;
} );

You also can hide the message with CSS on the front end by putting this code into your theme or in Customize > Additional CSS:

.rwmb-oembed-not-available {
display: none;