Setup Guide
Add PodEmbed to your website in under 5 minutes.
In this guide
1
What you'll need
- Your PodEmbed license key — Sent to your email after purchase
- Your podcast RSS feed URL — Get this from your podcast host (Libsyn, Buzzsprout, Transistor, Spotify for Podcasters, etc.)
That's it — no accounts to create, no files to download, and nothing to deploy. PodEmbed is fully hosted and ready to go.
Can't find your license key?
Check your email for a message from PodEmbed or LemonSqueezy with your license key. If you can't find it, contact support@tellstudios.com and we'll get it sorted.
2
Configure your player
Use the configurator to customize your player without writing any code:
- Go to podembed.com/configure
- Paste your podcast RSS feed URL — the player preview loads automatically
- Enter your license key (from your purchase confirmation email)
- Colors are auto-detected from your podcast artwork — you can override them if you like
- Optionally add Apple Podcasts and Spotify subscribe links
- Optionally add a CTA button (newsletter signup, course link, etc.)
- Choose your player size (Full Player, Compact Card, or Sticky Bar)
- Copy the generated embed code at the bottom of the page
Come back anytime
You can always return to the configurator to tweak your settings and re-copy the embed code. Nothing is saved on our end — your embed code contains all your settings.
3
Embed on your website
Paste the generated script tag anywhere in your website's HTML where you want the player to appear:
<script src="https://podembed.com/embed.js"
data-feed="https://feeds.libsyn.com/your-feed/rss"
data-license="YOUR_LICENSE_KEY"
data-accent="#e74c3c"
data-bg="#1a1a2e"></script>
The player will render inline, right where you place the script tag.
Choose a player size by adding the data-size attribute:
- Full Player (default) — Episode list, search, show notes, chapters. Best for dedicated podcast pages.
- Compact Card (
data-size="card") — A single-episode card with artwork, play button, and progress bar. Great for blog posts and landing pages. - Sticky Bar (
data-size="bar") — A thin bar fixed to the viewport. Perfect for site-wide persistent playback.
<!-- Compact card example -->
<script src="https://podembed.com/embed.js"
data-feed="https://feeds.libsyn.com/your-feed/rss"
data-license="YOUR_LICENSE_KEY"
data-size="card"></script>
Works everywhere
PodEmbed works on WordPress, Squarespace, Webflow, Wix, Ghost, Shopify, and any site that lets you add custom HTML. Just paste the script tag into an HTML block or code embed.
Multiple players on one page?
No problem! You can add multiple script tags with different settings — different sizes, different episodes, even different feeds. Your license key works on any page and any website.
Want a button that scrolls to the player? Add this anywhere above the player:
<button data-gyvb-open>Listen to the Podcast</button>
Clicking the button will smoothly scroll to the player.
4
All configuration options
These data-* attributes go on the <script> tag:
| Attribute | Description | Example |
|---|---|---|
data-feed |
Your podcast RSS feed URL (required) | https://feeds.libsyn.com/... |
data-license |
Your PodEmbed license key (required). Received via email after purchase. | FD36685B-1848... |
data-size |
Player size: full (default), card (compact single episode), or bar (sticky bar) |
card |
data-position |
Bar position: top or bottom (default). Only applies when data-size="bar". |
top |
data-accent |
Accent color (buttons, links, highlights) | #e74c3c |
data-bg |
Background color of the player | #1a1a2e |
data-apple |
Apple Podcasts URL for the Subscribe dropdown | https://podcasts.apple.com/... |
data-spotify |
Spotify URL for the Subscribe dropdown | https://open.spotify.com/show/... |
data-description |
Custom podcast description text | A show about... |
data-cta-url |
URL for the CTA button inside the player | https://your-site.com/signup |
data-cta-text |
Label text for the CTA button | Join the Newsletter |
data-episode |
Load a specific episode by title (single-episode mode) | My Best Episode |
data-episode-url |
Load a specific episode by audio URL | https://traffic.libsyn.com/... |
data-episode-guid |
Load a specific episode by GUID | abc123-def456 |
5
Troubleshooting
Player shows a license error
- Double-check that your
data-licensevalue matches the key from your purchase confirmation email - Make sure there are no extra spaces or missing characters in the key
- If you're still having trouble, email support@tellstudios.com with your purchase details
Player shows "Failed to load feed"
- Verify your RSS feed URL is correct and uses HTTPS
- Try opening the feed URL directly in your browser — you should see XML content
- Some podcast hosts have separate "public" and "private" feed URLs. Make sure you're using the public one
Player appears but no episodes load
- Your RSS feed might use a non-standard format. Open the feed URL in a browser and verify it contains
<item>elements - If your podcast is brand new, make sure at least one episode has been published
Colors look wrong
- Make sure your
data-accentanddata-bgvalues are valid hex colors (e.g.,#e74c3c, notred) - If omitted, the player auto-detects colors from your artwork. Use the configurator to preview and adjust
Player doesn't appear on my website
- Check the browser console for errors (F12 → Console)
- Some website builders strip script tags from content areas. Try using a "Custom HTML" or "Code Embed" block instead of a regular text block
- Make sure the script tag isn't inside another element that hides content (like a collapsed accordion or hidden div)