This configuration file lists the Embedded Media Providers configured for use in your Umbraco site.


    Each Embedded Media Provider is listed as a provider element. The provider configuration maps the Url of the 'resource to embed' to the code responsible for embedding that type of resource, using a regular expression.

    Anatomy of the configuration

    <provider name="YourEmbedProvider" type="YourEmbedNamespace.YourOEmbedClass, YourDllName">
        <requestParams type="Umbraco.Web.Media.EmbedProviders.Settings.Dictionary, umbraco">
        <param name="format">xml</param>
    • provider name - each provider should have a unique name
    • provider type - the 'type' of the code that provides the implementation, eg. "YourEmbedNamespace.YourOEmbedClass, YourDllName"
    • urlShemeRegex - The regex to match the url entered by the editor to the specific provider
    • apiEndPoint - Used with the generic Umbraco oEmbed providers, sets the url of the oEmbed endpoint to use for the provider
    • requestParams - Used with the generic Umbraco oEmbed providers, sets the type of the method responsible for sending additional querystring parameters to the embed Url, there are two methods provided:
      • Umbraco.Web.Media.EmbedProviders.Settings.Dictionary, umbraco
      • Umbraco.Web.Media.EmbedProviders.Settings.String, umbraco

    Example configuration

    <!-- Youtube Settings -->
    <provider name="Youtube" type="Umbraco.Web.Media.EmbedProviders.OEmbedVideo, umbraco">
        <requestParams type="Umbraco.Web.Media.EmbedProviders.Settings.Dictionary, umbraco">
            <param name="iframe">1</param>
            <param name="format">xml</param>
            <param name="scheme">https</param>

    The provider for YouTube is using the generic OEmbedVideo provider, matches a variety of youtube.com urls, and passes several parameters to the request.

    Check out the /config/embeddedmedia.config file for more examples.

    Custom Embedded Media Providers

    More information about creating your own Custom Embedded Media Providers can be found here