Georestricting

Sometimes, you need to restrict your cloud-hosted or registered content to viewers in certain countries. Georestricting gives you this control. Through your JWX dashboard, you can set georestricting rules for a property, multiple videos, or a single video.

📘
Georestricting rules apply only to the content played within a player. Georestricting rules do not impact player libraries nor playlists.

Georestricting allows you to protect your content and manage regional access. You can use it to:

Comply with licensing and distribution agreements
Restrict entire properties to specific geographic regions
Allow global access to promotional or free-to-view content while limiting other videos

When a viewer attempts to access your content, JWX checks their IP address against the countries you have allowed or denied. Depending on your configuration, playback will either be permitted or blocked.

How georestricting works

Georestricting behavior differs depending on how your content is hosted and which API endpoint is used to access it.

Cloud-hosted content

For content hosted on JWX’s cloud infrastructure, georestricting follows the behavior below.

Request	Behavior
Playlist requests	Georestricting rules are enforced for items returned in playlist responses (`/playlist` endpoint).
Manifest requests	Georestricting rules are also applied to direct calls for manifests (for example, `.m3u8` or `.mpd` URLs).
Playback JSON requests	Direct calls made to retrieve metadata for a specific media item (`/playback.json` endpoint) are not georestricted.

Externally hosted or registered content

For content that is hosted externally but registered in your JWX account, georestricting follows the behavior below.

Request	Behavior
Playlist requests	Georestricting rules are enforced for items returned in playlist responses (`/playlist` endpoint).
Manifest requests	Direct requests to externally hosted manifests are not georestricted.
Playback JSON requests	Direct calls made for a given media item (`/playback.json` endpoint) are not georestricted.

Applying georestricting rules

You can define georestricting behavior at multiple levels, depending on how broadly you want your rule to apply.

🚧
When both property-level and video-level rules exist, the video-level rules always take precedence.

Georestricting level	Description
Property	Set a geo-restriction for all cloud-hosted content within a specific property. Apply property-level geoblocking.
Video	Set geoblocking restrictions that are applicable to an individual video or to a group of videos. Apply video-level georestricting.