Modifying and Extending URL Embed

This page lists APIs, hooks, and other methods for customizing URL Embed.

Modify the response provided by oEmbed

Some oEmbed implementations provide parameters to modify what the provider returns as a response. For example X allows a "limit" parameter to limit the number of Tweets.

For scenarios like this, use hook_url_embed_options_alter()

Example usage

function my_module_url_embed_options_alter($url, &$config) {
  $parsedUrl = parse_url($url);

  if (($parsedUrl['host'] ?? '') == 'twitter.com') {
    $config = array_merge($config, ['oembed' => ['parameters' => ['limit' => 4]]]);
  }
}