Features Reference

Features are authorization mechanisms that allow apps to access specific types of data through our various APIs. In this way they are similar to Permissions, however Features cannot be granted to an app by an app user. Instead, Features are active or inactive depending on the app user's relationship to the app and the app's mode when it is being used.

For apps in Development Mode, all Features except for Page Public Content Access and Page Public Metadata Access are active for any app user who has a Role on the app or a Role in a Business that has claimed the app.

For apps in Live Mode, only Features approved through App Review are active for app users. This also applies to app user who have a Role on the app or Business.

For Business apps (which do not have modes), Features are active for any app users who have a Role on the app or in a Business that has claimed the app, unless access has been removed. In order for a Feature to be active for app users without a Role on the app or Business, it must first be approved through App Review.

Access to any Feature that is granted by default or through App Review can be used to request analytics insights to improve your app and for marketing or advertising purposes, through the use of aggregated and de-identified or anonymized information (provided such data cannot be re-identified).

Business Asset User Profile Access

The Business Asset User Profile Access feature allows your app to read the following User Fields for users engaging with your business assets:
  • id
  • ids_for_business
  • name
  • name_format
  • first_name
  • middle_name
  • short_name
  • last_name
  • picture

Allowed Usage

You can use this feature if your app uses one or more of the User Fields in its business app experience.

Additional Details

  • This permission or feature requires successful completion of the App Review process before your app can access live data. Learn More
  • This permission or feature is only available with business verification. You may also need to sign additional contracts before your app can access data. Learn More

Groups API

The Groups API feature allows your app to access content in a Facebook Group.

Allowed Usage

  • Help people manage the posts and content published to their Group.
  • Help people get information about content posted to their Group.
  • Let people publish content from your app to their Facebook Group.
  • Help people get aggregated insights about activity happening in their Group.

Additional Details

Instagram Public Content Access

The Instagram Public Content Access feature allows your app to access Instagram Graph API's Hashtag Search endpoints.

Allowed Usage

  • Discover content associated with its current campaign.
  • Provide customer support.
  • Identify entrants to its contests, competitions, or sweepstakes.
  • Understand public sentiment around brand.
  • Understand and manage their audience, develop their content strategy and obtain digital rights.

Additional Details

  • This permission or feature requires successful completion of the App Review process before your app can access live data. Learn More
  • This permission or feature is only available with business verification. You may also need to sign additional contracts before your app can access data. Learn More

Live Video API

The Live Video API feature allows an app to post live videos to Pages, Groups and User timelines when combined with the correct matching permission.

Allowed Usage

  • App users can publish live video content from your app to Facebook.

Additional Details

  • This permission or feature requires successful completion of the App Review process before your app can access live data. Learn More

Page Mentioning

The Page Mentioning feature allows your app mention any Facebook Page when publishing posts on the Pages managed by your app.

Allowed Usage

  • Allow people to use your app to publish Page posts that mention other Pages.
  • Mention Pages relevant to the content in your page post.

Additional Details

  • This permission or feature requires successful completion of the App Review process before your app can access live data. Learn More
  • To use Page Mentioning, your app need to have been granted the pages_read_engagement and pages_manage_posts permissions.
  • If your app has its own user authentication system, please include a working username and password in your review instructions so our team can easily reproduce your page mentioning functionality.

Page Public Content Access

The Page Public Content Access feature allows read-only access to public data on Pages for which you lack the pages_read_engagement permission and the pages_read_user_content permission.

Allowed Usage

  • Provide competitive benchmark analysis.

Additional Details

  • This permission or feature requires successful completion of the App Review process before your app can access live data. Learn More
  • This permission or feature is only available with business verification. You may also need to sign additional contracts before your app can access data. Learn More
  • While you are testing your app and before you submit it for review, your app can only access content on a Page for which the following is true: The person who holds the admin role for the Page also holds an admin, developer, or tester role on the app. If you want the app to be able to access public content on other Pages, you must submit this feature for review. Once you set your app to live mode, it will not be able to see any Page public content without this feature.

Page Public Metadata Access

The Page Public Metadata Access feature grants your app permission to read public Page fields and the Pages Search API.

Allowed Usage

  • Analyze engagement with public Pages by viewing Like and follower counts.
  • Aggregate public-facing "about" Page information from multiple, disparate pages.

Additional Details

  • This permission or feature requires successful completion of the App Review process before your app can access live data. Learn More
  • This permission or feature is only available with business verification. You may also need to sign additional contracts before your app can access data. Learn More
  • If your app also needs to read the Page Feed edge, or Comments on a Page's Posts, request the Page Public Content Access feature instead.
  • This feature is superseded by the Page Public Content Access (PPCA) feature. If your App Review submission includes PPCA, or your app has already been approved for PPCA, you cannot request this permission.
  • If your app also needs to create, update, or delete data on a Page, request the pages_read_engagement permission instead.

Threat Exchange

The ThreatExchange feature allows your app to share threat data among a select group of vetted industry partners.

Allowed Usage

  • Share threat data with a specific group of partners to achieve their security goals.

Deprecated Features

FeatureDeprecation Date

All Mutual Friends API

October 24th, 2018

Profile Expression Kit

September 30th, 2018

Optimized Sharing to Messenger

August 1st, 2018

Taggable Friends

April 4th, 2018