Skip to main content

​
Introduction

Motto offers geo-blocking protection rules as a way to prevent your end-users from viewing your content from regions where you may not have the rights to publish it.

​
Get Started

You can get started using the Motto Studio, which we recommend for non-technical users. Alternatively, you may get started by using the Motto API.
To enable geo-blocking, first navigate to the “Settings” section in the Motto Studio, and select the “Video protection” tab. Here you can create a new ruleset by clicking the “New ruleset” button, or edit an existing ruleset if you are already applying other protection measures to the same content.In the creation form, you can check the option to enable geo-restrictions. You can then select a list of countries that you wish to allow or disallow playback from.
To enable geo-blocking, you must create a video protection ruleset with the geo_restrictions_allow or geo_restrictions_disallow array populated (not both).Each element should contain a two-character country code following the ISO 3316-1 alpha-2 standard, e.g. US or FR. These country codes represent where a viewer is (or is not) allowed to watch from, respectively.
Make sure to apply the ruleset to the content you wish to protect by selecting the appropriate target(s). For more information, see selecting a target.
You may change these settings at any time, even while a stream is already live. New rules will take roughly one minute to lodge. However, users already viewing your stream may not be affected until they reload the page or app.

​
Impact

Once geo-blocking has been turned on, your end-users in disallowed countries will no longer be able to view your playlist when attempting to play it. Instead, the stream resource will throw a 4xx HTTP status code. The Content Delivery API also performs a geo-blocking check, and will return an error upon trying to retrieve a playlist URL for playback. If the Motto video player is being used, a visual error will also appear to clarify the issue to your end-users.

​
Next Steps

Have a look at any of the other rights protection features that Motto offers: