Block Access to a Real-time Stream Based on Geographic Boundaries

Geo-blocking refers to the action of restricting access to certain content based on the geographical location of the user. Filtering can be allowed or denied by countries as well as IP addresses. Geo-blocking enables content providers to adhere to specific licensing agreements and distribution rights, protect copyrighted material, or service another layer of privacy when working on private content.

You can set geo-blocking in either your publish token or subscribe token. Geo-location in both tokens refers to the location from which viewers can watch a stream. If you restrict access to a stream in some countries using the publish token, people from those countries will not be able to watch the streamed content, even if the stream is unauthenticated and does not require the subscribe token. Geo-blocking does not impact broadcasting.

Geo-blocking in the dashboard

There are some settings you can use when configuring geo-blocking.

  • Allow countries lets you specify one or more countries by name that should be permitted to broadcast or view a stream.
  • Deny countries lets you specify one or more countries that should be prohibited from broadcasting or viewing a stream.

End viewers that will be blocked from content will see a message in the player stating Country not allowed when trying to access the viewer. You can test this by blocking the country from which you are based to access the secure viewer link.

How-to allow or block countries for all tokens

You can define token defaults that are applied account wide as a global configuration. They can be overridden on a per-token basis

Log into your account Streaming Dashboard, click on Settings in the left-side menu.

Navigate to the Token defaults tab.


Select from the countries you want to allow or deny from the alphabetical dropdown list.


Applied to All Tokens

Enabling geo-blocking account wide will have all previous and future publish tokens enabled with this feature. To disable it simply erase the specified countries and the new conditions will be updated.

How-to allow or block countries for a specific token


Getting Started

If you haven't already, begin by following the Getting Started tutorial to create a application and start your first broadcast. You will need to have a publishing token.

Open the Streaming section of the Dashboard and select an existing token or + Create a new one.

Toggle the Geo-blocking setting to enable it for a token.

For a new token, you can do this by selecting the Advanced tab during creation and toggling the Geo-blocking to be Enabled.

Select from the countries you want to allow or deny from the alphabetical dropdown list.


Block by IP Address or Domain

You can also deny access to content if you know the domain name or ip address that will be used to broadcast or view a stream.

Learn more

Learn more by exploring the developer blog and code samples.