Regional restrictions

You can restrict playback in the player regionally using the Geolocation plugin.

Firstly you need to specify a link to the geolocation service. Many of these services (paid and free) can be googled by ip location api keywords. It is important that the service supports the HTTPS, CORS and JSON response (the player searches for the country code in the country_code or countryCode parameters in the response). You can also deploy your geolocation service if you think it's necessary.

To allow content to be played in the specified regions, enter country codes separated by commas. Country codes must be in two-character ISO-3166-1 format in any case (lowercase or uppercase characters). Example to allow playback in all countries of the European Union:


If you want to deny playback, specify codes with the NO_ prefix. Example for all South American countries:


You can not mix prohibitions and permissions, you need to use one of them.

If the geolocation service does not respond, or does not have time within the timeout, the content will be displayed by default. You can change this behavior in the plugin settings. You can also set a special text, image, or video for the screen with a notification about the restriction.

The geolocation service is also used for ad geotargeting.

This plugin is available in the full PRO version of the builder.

2024 © PlayerJS

Sign up free

Sign up
By signing up, you agree to Terms of Service
Login if you have an account

Restore password

Forgot email? Contact us