Content Management | Spotify for Developers

https://developer.spotify.com/documentation/open-access/tutorials/content • 203 KB fetched
Open original page
Content Management | Spotify for Developers Skip to content

* Documentation Documentation Products
* Web API

* Web Playback SDK

* Ads API

* iOS

* Android

* Embeds

* Commercial Hardware

* Open Access

* Spotify Soloist
Guidelines
* Design

* Accessibility

* Legal

* Community

0

* Documentation Documentation Products
* Web API

* Web Playback SDK

* Ads API

* iOS

* Android

* Embeds

* Commercial Hardware

* Open Access

* Spotify Soloist
Guidelines
* Design

* Accessibility

* Legal

* Community

Open Access

* Overview

* Concepts

* Tutorials Tutorials Tutorials
* Account Linking

* Content Management

* Changelog
Reference
* Add user entitlements

* Create new partner

* Get user entitlements

* Register new user

* Removes user entitlements

* Replace user entitlements

* Set partner logo

* Unlink user

Open Access
* Overview

* Concepts

* Tutorials Tutorials Tutorials
* Account Linking

* Content Management

* Changelog
Reference
* Add user entitlements

* Create new partner

* Get user entitlements

* Register new user

* Removes user entitlements

* Replace user entitlements

* Set partner logo

* Unlink user

Content Management

Content access

SOA uses a concept of entitlements to control how users can access restricted
content. Entitlements are
identifiers that the partner defines and assigns to users and episodes. An
episode is playable if the user and the episode have at least one entitlement
identifier in common.

User entitlements are supplied by the partner during the authentication
process. A user can have 0, 1, or multiple active entitlements.

Episode entitlements are defined in the RSS feed during ingestion. An episode
can have 0, 1, or multiple entitlements. Episodes with 0 entitlements are
publicly available without further authorization.

In the Lunar Industries example, in the content:

* Moonshots will have no entitlements attached to any episodes.

* The Dark Side has its bonus episodes tagged with the "lunar_dark_side" entitlement.
Living on the Moon has all its episodes (except the teaser trailer) tagged with the "lunar_living" entitlement.

And for the users:

* Users that subscribe to the "Bonus Content" tier are given the "lunar_dark_side" entitlement.

* Users that subscribe to the "Premium" tier are given both the "lunar_dark_side" and "lunar_living" entitlements in their tokens.

An example for the Lunar Industries show The Dark Side is below. This
is not complete RSS as it is of course missing many tags required for full
ingestion, but we highlight some SOA details. You can also view the show's RSS
feed
directly .

_ 22 <?xml version="1.0" encoding="UTF-8"?>

_ 22 <rss xmlns:spotify="http://www.spotify.com/ns/rss">

_ 22 <channel>

_ 22 <title>The Dark Side</title>

_ 22 <description>Lunar's Bonus Content</description>

_ 22 <spotify:access>

_ 22 <partner id="2zkvpokj55bj2sCHxCejJs"/>

_ 22 </spotify:access>

_ 22 <item>

_ 22 <title>Free Episode #1</title>

_ 22 <!-- Note no spotify:access section -->

_ 22 <enclosure url="https://l-i.com/free1.mp3" length="10" type="audio/mpeg"/>

_ 22 </item>

_ 22 <item>

_ 22 <title>Bonus Episode #1</title>

_ 22 <spotify:access>

_ 22 <entitlement name="lunar_dark_side"/>

_ 22 </spotify:access>

_ 22 <enclosure url="https://l-i.com/bonus1.mp3" length="10" type="audio/mpeg"/>

_ 22 </item>

_ 22 </channel>

_ 22 </rss>

Similarly, the Living on the Moon RSS would have all its episodes tagged:

_ 24 <?xml version="1.0" encoding="UTF-8"?>

_ 24 <rss xmlns:spotify="http://www.spotify.com/ns/rss">

_ 24 <channel>

_ 24 <title>Living on the Moon</title>

_ 24 <description>Lunar's Premium Content</description>

_ 24 <spotify:access>

_ 24 <partner id="2zkvpokj55bj2sCHxCejJs"/>

_ 24 </spotify:access>

_ 24 <item>

_ 24 <title>Living Episode #1</title>

_ 24 <spotify:access>

_ 24 <entitlement name="lunar_living"/>

_ 24 </spotify:access>

_ 24 <enclosure url="https://l-i.com/ep1.mp3" length="10" type="audio/mpeg"/>

_ 24 </item>

_ 24 <item>

_ 24 <title>Living Episode #2</title>

_ 24 <spotify:access>

_ 24 <entitlement name="lunar_living"/>

_ 24 </spotify:access>

_ 24 <enclosure url="https://l-i.com/ep2.mp3" length="10" type="audio/mpeg"/>

_ 24 </item>

_ 24 </channel>

_ 24 </rss>

View the full RSS feed here .

Supporting many shows

In the case that a partner has a large number of shows which are bundled, it
may make more sense to define entitlements that map to a "tier" rather than
individual shows, to reduce the size of the set of entitlements that would need
to be sent in register and update calls. Spotify Open Access supports this as
well - it is up to the partner how to define entitlements.

Content ingestion

All gated content will be ingested and served through the Spotify platform.

RSS ingestion

RSS-based podcast feeds are submitted through
podcasters.spotify.com .

Content ingested through RSS must conform to the Spotify Podcast Delivery
Specification
in addition to the addenda in this section.

Spotify recommends having an RSS feed that is specific to Spotify ingestion,
which contains the additional information described in this section.

For the ingestion of a podcast RSS feed that has a mix of free and paid
episodes, Spotify has introduced two new fields in the spotify namespace in the
RSS that will allow the ingestion of the mixed subscription tier episodes for
the podcast show. The two fields are partner-id at the channel level:

_ 10 <spotify:access>

_ 10 <partner id="2zkvpokj55bj2sCHxCejJs"/>

_ 10 </spotify:access>

and entitlement at the item level -- example from The Dark Side restricted episode:

_ 10 <spotify:access>

_ 10 <entitlement name="lunar_dark_side"/>

_ 10 </spotify:access>

Note that in the opening xml tag, the Spotify namespace must be referenced,
using xmlns:spotify="http://www.spotify.com/ns/rss"

Sandbox mode

Sandbox mode allows partners to test a show before it becomes widely available
to Spotify users. A sandboxed show can be accessed only via a direct link if
the link is known: https://open.spotify.com/show/0CTGu9RccEYBWxDJF1LovM . It
will not be available through search and it will not be recommended to users.
The same applies to all the episodes in the show.

Spotify has introduced a new field in the spotify namespace in the RSS that
will allow sandbox mode. The field is sandbox at the channel level:

_ 10 <spotify:access>

_ 10 <partner id="2zkvpokj55bj2sCHxCejJs"/>

_ 10 <sandbox enabled="true"/>

_ 10 </spotify:access>

All shows from our example partner Lunar Industries are sandboxed. Try searching for Living on the Moon on Spotify or view the RSS feed to verify how it works.

Once a show is tested and is ready to be consumed by Spotify users, remove the
tag altogether or mark sandbox enabled as false.

_ 10 <spotify:access>

_ 10 <partner id="2zkvpokj55bj2sCHxCejJs"/>

_ 10 <sandbox enabled="false"/>

_ 10 </spotify:access>

Note that this only goes into effect when the partner-id field is also
present; a sandbox tag on its own has no effect. This field can be toggled as
suited. However, some surfaces might not be covered. For example, if this show
has previously been searched by a user, since search results are heavily
cached, it might still show up on a search for that user. If it has been added
to a user’s library, it will stay available.

Content protection

Content hosted on the Spotify platform is protected by Spotify's content
protection/DRM systems.

Restrictions are enforced by services in the Spotify backend, ensuring that
only authorized users are allowed to stream a particular media item.
Restrictions take into account the content's availability markets and dates,
and the user's authorization status (for SOA content).

Footer
Documentation

* Web API

* Web Playback SDK

* Ads API

* iOS

* Android

* Embeds

* Commercial Hardware

Guidelines

* Design

* Accessibility

Community

* News

* Forum

Legal

* Developer Terms

* Developer Policy

* Compliance Tips

* Third Party Licenses

Legal Cookies © 2026 Spotify AB
Content Management | Spotify for Developers

Links found on this page
