Sélectionner une page

List Mixcloud

List MixCloud — WordPress Plugin

WordPress Plugin

List MixCloud

Embed any MixCloud channel on your WordPress site — as a single player, a scrollable list, or an interactive playlist — with one shortcode and zero API keys required.

Free & open source 7,000+ active installs WordPress 6.7 tested Gutenberg block included Security patched — CVE-2025-28930
↓ Download on WordPress.org

Overview

Your Mixcloud channel, on your site

List MixCloud fetches podcasts, mixes, and radio shows directly from Mixcloud’s public API and renders them using the official Mixcloud widget embed. No account login, no API token, no third-party service — just the channel name.

API responses are cached for one hour out of the box, so repeated page loads never trigger unnecessary network requests.

🎙️ Three widget styles

Mini bar, classic bar, or square picture — choose what fits your layout.

📋 Playlist mode

One player at the top, a clickable tracklist below. Click a title to load and play it instantly.

⚡ Built-in cache

WordPress transients keep API calls to a minimum. TTL is filterable.

🧱 Gutenberg block

Configure and preview the player directly inside the block editor, no shortcode required.

🔒 Security-hardened

All output is properly escaped. CVE-2025-28930 (XSS) resolved in v1.5.

🔁 Backward compatible

Existing shortcodes and widgets from older versions keep working without changes.

Getting started

Up and running in three steps

No configuration page. No API key. Just install, activate, and paste a shortcode.

1
Install the plugin

Search for List MixCloud in Plugins → Add New, click Install then Activate. Or upload the zip manually.

2
Find your Mixcloud channel name

It’s the slug in your Mixcloud URL: mixcloud.com/YourChannelName/

3
Add the shortcode to any page or post

Paste it into a Shortcode block, a Classic editor, or anywhere shortcodes are supported.

Shortcode reference

Simple by default, flexible when you need it

The only required attribute is channel. Everything else has a sensible default and can be omitted.

Shortcode — minimal [listmixcloud channel=‘YourChannelName’]
Shortcode — playlist mode with all options [listmixcloud channel=‘YourChannelName’ widget=‘mini’ playlist=‘1’ mode=‘5’ autoplay=‘0’ style=‘Light’ width=‘100%’ hide_artwork=‘0’ ]
Attribute Description Default
channel Your Mixcloud username (the slug from the URL) required
widget Player style: mini, classic, or picture mini
mode Number of episodes to show. 0 loads all available episodes. 0
playlist Set to 1 to show a single player with a clickable episode list below 0
autoplay Set to 1 to start playback automatically on page load 0
style Widget color theme: Light or Black Light
width Player width in pixels or percentage, e.g. 400 or 100% 100%
hide_artwork Set to 1 to hide the episode artwork inside the player 0

Live example

What it looks like on your page

The shortcode below produces a mini player with an interactive playlist showing the last 5 episodes from the channel.

Shortcode used in this example [listmixcloud channel=‘EgliseEvangéliqueDeTOURS’ playlist=‘1’ mode=‘5’]
Result on your page
  • Adversité (Jeunesse) - Cédric MERCIER - 24 10 2020
  • La Pentecôte - Pasteur Frédéric Moreau - 09 06 2019
  • Les signes des derniers temps - F Lefillatre - 09 02 2020
  • Esclaves de Jésus Christ - Pasteur Frédéric Moreau - 08 03 2020
  • La communion et l'onction dans l'église - Pasteur Vincent Luc - 01 03 2020

For developers

Filter the cache duration

API responses are cached for one hour by default using WordPress transients. You can override the TTL in your theme’s functions.php or in a custom plugin:

PHP — functions.php add_filter( ‘list_mixcloud_cache_ttl’, function() { return 1800; // 30 minutes } );