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.
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.
Via the Studio
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.
Via the API
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.
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.
Motto’s geo-blocking feature is in compliance with the portability laws set forth by the European Union.Under the EU’s Portability Regulation (EU) 2017/1128, if you legally subscribe to or purchase digital video content in
one EU country, you must be able to access and use that content temporarily while present in another EU country under the
same conditions (e.g. catalog, quality, and functionality) as at home.Motto solves this by keeping track of the origin country of the purchase as a part of the entitlement
(which is the object that grants a user access to video content based on their purchase). This origin country is then evaluated
along with the IP-based location of the user, when that user tries to view that purchased piece of content.More information can be provided upon request, as needed.
