Card URL previews
Iframely generates cards as URL previews when we can't find rich media embed codes from the publisher.
If allowed in your settings, Iframely will try to generate a card previews. It follows this logic.
- Simple summary card for any public URL we have a thumbnail image for, if no other rich media is found from publisher.
- Summary card as fallback when publisher's rich media won't work for your user (Flash-only, or lack of SSL support) or when you specifically disabled that particular type of rich media in your settings.
- Media card, when we find rich media that is attached to the article (say, a post with embedded YouTube video in it).
- Media card for any video URL, if requested with
&iframe=cardAPI parameter or configured as preference in your settings.
Cards rely on our iFrames and follow the design your configure in your settings.
When Iframely suggests a summary preview for your URL, the primary
rel array of Iframely API will contain
summary in it. For media card, we'll add
promo to the list of rels. oEmbed API endpoint returns both as
Summary cards are URL previews. We do it for articles, media players that are not whitelisted, and also for general URLs that at least have a thumbnail image (thus, trying to avoid private links and internal in-app URLs).
Card for articles
Or a compact one
To always get a summary card (i.e. disable rich media for a particular URL), you can make your API requests with
&media=0 in query-string parameters.
Compact card is generated when we only have a smaller or portrait thumbnail image. Plus, you can also force a compact card in your cards settings or by adding
&iframe=card-small parameter to your API call.
Media cards wrap rich media such as players into a card with all URL attribution details. By default, we do it for players that are "attached" to the article - meaning that they do not represent the main content of the webpage (or simply don't have an attribution link to the canonical URL). You can also request it for any player by adding
&iframe=card to your API call.
Compact & click-to-play
Media cards can be combined with click-to-play and also will support player events if requested. A compact media card will always go with click-to-play, even if we don't actually have an auto-playing media.
Change design of the cards
You can change the layout and design for the cards via our flexible WYSIWYG editor. Load a few samples from presets to get some inspiration. Change the design of click-to-play buttons separately in your player settings.
Let us know if you need a hand with it.