Setup Usage Docs


A simple, lightweight and standalone content embed plugin for web

embedo / Embed Guidelines

Embedo only works for public URI having no authentication required or promising cross-domain policies of the host. It uses oEmbed API endpoints for facebook, twitter, instagram and vimeo acting more as a wrapper around respective API which allows using existing field-value set as explained further in documentation.

Facebook Page, Posts and Comments

This supports only public entities as page, post, videos, photos or comment(s).

The URL must contain the pageId or pageUsername and URL for photos, posts or videos should look or closer which support this expression.[FACEBOOK_HANDLE][FACEBOOK_HANDLE]/photos/[SESSION_OR_USER_SCOPE_ID]/[POST_ID_HERE][FACEBOOK_HANDLE]/posts/[POST_ID_HERE][FACEBOOK_HANDLE]/videos/[POST_ID_HERE]/[FACEBOOK_HANDLE]/posts/[POST_ID_HERE][FACEBOOK_HANDLE]/videos/[POST_ID_HERE][FACEBOOK_HANDLE]/posts/[POST_ID_HERE]?comment_id=[COMMENT_ID][FACEBOOK_HANDLE]/posts/[POST_ID_HERE]?reply_comment_id=[REPLY_COMMENT_ID]

PS: If you’re running this in headless browsers (eg. phantom) or demos on jsfiddle/codepen/etc, facebook SDK will throw security exception due to recent changes in their server. But it will work normally when script is imported.


Twitter - Tweets, Timelines and Grid

This is straightforward, the exact twitter URL can be embedded while passing options from oembed API.[TWITTER_HANDLE][TWITTER_HANDLE]/status/[TWEET_ID][TWITTER_HANDLE]/timelines/[TIMELINE_ID]

For Timeline embed:

embedo.load(HTMLElement, '')

For Timeline Grid embed:

embedo.load(HTMLElement, '', {
  widget_type: 'grid'


Instagram Posts

Only posts can be embedded, no timeline. So your URL should be closer to this pattern:[POST_ID_HERE]


YouTube Videos

Supports URLs matching /watch?v= or /embed in URL should work. Avoid playlist(s) URL.[VIDEO_ID][VIDEO_ID][VIDEO_ID]


Supports URLs matching video or channel links.[VIDEO_ID][CHANNEL_HANDLE]/[VIDEO_ID]


By default, supports Pins embed.[PIN_ID]

For Board embed:

embedo.load(HTMLElement, '', {
  'data-pin-do': 'embedBoard',
  'data-pin-board-width': 400,
  'data-pin-scale-height': 240,
  'data-pin-scale-width': 80,
  'strict': true // To allow above size dimensions to be used

For Profile embed:

embedo.load(HTMLElement, '', {
  'data-pin-do': 'embedUser'



The external links, based upon detected mime gets embed either in <iframe> or <video> elements. These could be any URL possible which has public access or cross-domain disabled.

Its also possible to override the HTML Tag using:

embedo.load(HTMLElement, 'https://my.awesome/url/here', { tagName: 'embed' })