Gem Version

blacklight-oembed adds OEmbed displays for Blacklight's search results views.


Add this line to your Blacklight application's Gemfile:

gem 'blacklight-oembed'

And then execute:

$ bundle

Or install it yourself as:

$ gem install blacklight-oembed


Run the blacklight-oembed generator:

$ rails g blacklight_oembed:install

The generator will provide reasonable defaults and inject oembed configuration into your CatalogController.

In your solr index, you need a field containing the URL to an oembeddable object. blacklight-oembed will use that URL to render the oembed viewer on your catalog#show page. The name of the field can be configured in your Blacklight configuration:

# app/controllers/catalog_controller
class CatalogController
    configure_blacklight do |config|
        # these are generated into your configuration by the install generator. = :oembed_url_ssm, :oembed)

In an initializer, you may want to register additional oembed providers for the ruby-oembed, e.g.:

# config/initializers/oembed_providers
require 'oembed'


purl_provider ="{format}?&hide_title=true")
purl_provider << "*"

You need a solr field containing a URL to an embeddable object.

Additional configurations

Blacklight OEmbed allows for more configurations. In an initializer, you can add additional params that will be passed through to an OEmbed provider.

# config/initializers/blacklight_oembed.rb
Blacklight::Oembed::Engine.config.additional_params = [:canvas_index]


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request