Embedding content on your site

Usage

Getting the embed code

Embed button example

You can embed most of our audio content directly into your site, using the embed button on episode, channel, or provider pages.

When embedding a provider, our system will embed the provider's latest available episode.

When embedding a channel, our system will automatically select one of the channel's episodes to embed — for News or Podcast channels this will always be the latest episode that is available, while Book or Series channels always provide the first available episode.
This means for example that you can always get the latest News episode by embedding it's channel instead of a specific episode!

Using the embed code

The easiest, and recommended, method of embedding a player on your site is to paste the <iframe> code as-is into your HTML. The code will look something like the following:

<iframe src="https://embed.iono.fm/chan/78" width="100%" height="450" frameborder="0"><a href="https://www.iono.fm/c/78">Content hosted by iono.fm</a></iframe>

WordPress integration

You can add iono.fm as an oEmbed provider on your WordPress blog by adding the following code to your theme's functions.php file.

wp_oembed_add_provider('#https?://(www\.)?iono\.fm/(p|c|e)/.*#i', 'https://embed.iono.fm/oembed', true);

You can find out more about embedding content in WordPress by reading this article.

Unsupported browsers

Fallbacks are provided for browsers which do not support the latest HTML5 features. Depending on your browsers level of support you may get a fallback with audio controls, or a fallback with a simple download link.

Customising the embed content

Our embeds can be configured to your needs by adding one or more of the following url parameters to the embed url.
Playlists are enabled by default on provider and channel embeds, and can be controlled using the playlist parameter.

Breakdown of embed parameters
Parameter Description
height The height, in pixels, of the embedded control.
playlist The type of playlist to embed.
  • none – Removes the playlist from the embed.
  • latest(Default) Displays the latest episodes.
  • today – Displays latest episodes for today.
  • yesterday – Displays latest episodes for yesterday.
  • popular – Displays most popular episodes over the last month.
description Whether or not to include the episode description in the player.
  • 0(Default) Disables episode descriptions.
  • 1 – Enables episode descriptions.
quality The default quality profile of the player. Visit our knowledgebase article for more information on the different quality profiles.
  • low – Low quality profile.
  • medium(Default) Medium quality profile.
  • high – High quality profile.
  • hifi – Hi-Fi quality profile.

Example

We provide an <iframe> fragment that currently contains an HTML5 player with a download link as fallback for browsers that don't support HTML5 audio.

Here is a live example of what embedded content will look like on your site:

Errors

Depending on the status of the requested content, your embed may return one of the following errors:

Content not found
Premium content
Archived content
Closed group content