User restrictions can be applied to Open Graph stories to make the content available to approved audiences. The news feed, ticker and timeline stories can be filtered by country, age, and content. For example, a music app can specify that stories published by their app may only appear in countries in which they have launched. Alternatively a video app can restrict stories from movies rated PG13 to viewers age 13+, and restrict movies rated NC17 to viewers age 17+.
Restrictions can be applied on an app-level or on an object-level.
An app-level restriction is applied through the App Dashboard Advanced settings:
Country Restrictions - Enter one or more countries to specify that your app will only be visible to people in the listed countries. If no countries are listed, your app will be visible to people located in all countries. You understand that you are responsible for setting the proper country restrictions to ensure that the content of your app is appropriate for the country or countries where you allow it to be visible. Use the type ahead to specify the countries to whitelist your app for.
Age Restrictions - Selecting an age restriction means that anyone under the specified age will not be able to find your app in search or on friends' profiles or view the content in other ways. Age ranges for the logged in user will be returned in the signed_request (see Age Object) for Canvas Apps and should be used to help restrict content accordingly.
Content Restrictions restricts the app use based on content. The Alcohol-Related age restriction sets the minimum age based on the location of the user. Only users in Canada, South Korea or Nicaragua who are 19+, in Japan, Iceland or Paraguay who are 20+, in Cameroon, Micronesia, Palau, Solomon Islands, Sri Lanka or the U.S. who are 21+, in India and Sweden who are 25+, and elsewhere who are 18+ will be able to view your app. You understand that the Alcohol-Related age restriction is for convenience and that Facebook does not represent that by using that setting your app will be legally compliant in all countries where your app is visible. You understand that ultimately you are responsible for setting the proper legally compliant age restrictions for each country where your app is visible.
If there are multiple restrictions applied against a story the most restrictive option will be applied. For example, if you select 17+ age restriction and alcohol content restriction, then users in locations where the law restricts alcohol content being shown to users over 21 years, then those user would not be able to view the content. In this example, the 21+ year is the most restrictive option and will be applied.
An object-level restriction is applied through setting the Open Graph markup for the web page that represents an object.
This allows you to send markup to specify countries allowed to use the app (whitelist) or countries that cannot see the app (blacklist). The countries can be specified through the two-letter ISO country code, e.g. ''US'' represents United States.
<meta property="og:restrictions:country:allowed" content="US" /> <meta property="og:restrictions:country:disallowed" content="CN" />
You can only have
og:restrictions:country:disallowed in the markup. Mixing these two will result in an error.
This allows you to send markup to specify the age restriction. See more details for the Age Object passed in the signed_request parameter.
<meta property="og:restrictions:age" content="13+"/> <meta property="og:restrictions:age" content="17+"/> <meta property="og:restrictions:age" content="18+"/>
This allows you to restrict based on content. The ''alcohol'' content type is currently the only one supported.
<meta property="og:restrictions:content" content="alcohol"/>