Geo-targeting

Geo targeting allows you to control content availability by matching the viewer country or rights location against specific rules defined in the content metadata. In most cases, geo location refers to the viewer country or designated rights location.

By default, the viewer's geo location is determined using the viewer's IP address. However, you can explicitly set the location using the SDK.

How it works

The platform evaluates content availability in two steps:

1. Determine viewer location

The platform identifies the viewer's country (using standard ISO 3166-1 alpha-2 codes) in one of two ways:

Default (IP-based): If no location's provided via the SDK, the platform uses CDN-provided geolocation derived from the viewer's public IP address.
Override (SDK-based): If your app explicitly sets a country code in the SDK, this value overrides the IP-based detection and becomes the effective location for evaluation.

2. Evaluate content availability rules

Each asset contains metadata that explicitly includes or excludes specific countries. The platform compares the effective viewer location against these rules:

Include: Content's only available if the viewer's country's on the allowed list.
Exclude: Content's available everywhere except in the countries on the restricted list.

If no geo-targeting rules are defined for an asset, it's available globally.

Set asset geo-targeting

You can manage these settings for individual assets or in bulk.

In CMS, go to:
- For a single asset: Select the asset, click Preview, then select Geo-targeting.
- For multiple assets: Select the assets, click Geo, and then select Edit geo settings.
Choose a method:
- Include: Restrict content to specific regions.
- Exclude: Block content in specific regions.
Select regions: Choose one or more countries to apply the policy.