Help › EmbeddingFor quick answers tweet @buzzsprout

Advanced Embedding Tips

How to only return episodes with certain tags

With the Buzzsprout players, you can pass in a tag parameter that will only return the episodes that match the specified tag(s). This comes in handy if you have 2 categories of episodes that you want to keep separate, but want to host them under the same account.

For example, if I wanted to create a player that only returned episodes that had to do with Football, I can add the tag “Football” to any episode I want in Buzzsprout using the “Tags” field:

Embedding with Tags

And then adding a small addition to my embed code after "?player=":

HTML5 & Flash Player

<script src="http://www.buzzsprout.com/XXXX.js?player=small&tags=football" type="text/javascript" charset="utf-8"></script> 

HTML Only

<script src="http://www.buzzsprout.com/XXXX.js&tags=football" type="text/javascript" charset="utf-8"></script> 

One Large Flash Player

<script src="http://www.buzzsprout.com/XXXX.js?player=large&tags=football" type="text/javascript" charset="utf-8"></script> 

This will tell the player to only return episodes with that tag. If I give new episodes that tag, they’ll automatically show up in that player.

If you want to add more than 1 tag, just separate them with a comma.

How to limit the number of episodes returned

When you embed your podcast on your site, you can pass in a limit parameter that will limit the number of episodes returned. Just pass in a limit of 1 to grab your most recent episode (or 2 or 3 or whatever). Below are example embed scripts with a limit of 1 added:

HTML5 & Flash Player

<script src="http://www.buzzsprout.com/XXXX.js?player=small&limit=1" type="text/javascript" charset="utf-8"></script>

HTML Only

<script src="http://www.buzzsprout.com/XXXX.js?limit=1" type="text/javascript" charset="utf-8"></script> 

One Large Flash Player

<script src="http://www.buzzsprout.com/XXXX.js?player=large&limit=1" type="text/javascript" charset="utf-8"></script>

How to change the default episode sorting

By default all episodes are sorted with the most recent episode first. Below are example embed scripts that would put the episodes in order by date with the oldest episode first:

HTML & Flash Player

 <script src="http://www.buzzsprout.com/XXXX.js?player=small&order=date" type="text/javascript" charset="utf-8"></script> 

HTML Only

 <script src="http://www.buzzsprout.com/XXXX.js&order=date" type="text/javascript" charset="utf-8"></script> 

One Large Flash Player

 <script src="http://www.buzzsprout.com/XXXX.js?player=large&order=date" type="text/javascript" charset="utf-8"></script> 

That part where it says &order=date is what you would add and change "date" to whatever you would like to sort your episodes by. For example, if you wanted to sort by title, you would replace "date" with "title".