Open Graph Stories
How It Works
People use stories to share the things they're doing, the people they're doing them with and the places where they happen. Let people share stories about your app on Facebook through a structured, strongly typed API.
To publish Open Graph stories with the Share dialog, you do not need to implement Facebook Login or ask for additional permissions. For more information, see Share Dialog.
If you create a custom sharing UI to publishing Open Graph stories, you need to implement Facebook Login and request the
publish_actions permission from people using your app. This also means you need to submit your app for review, see Login Review. Both of these steps help make sure people using your app are aware of the action they are taking by sharing and helps provide a high-quality experience.
If you create custom Open Graph actions and objects for your app, you should also submit your app for review to ensure your new objects, actions and capabilities associated with actions comply with Facebook policies. See App Review.
Open Graph stories have four basic elements:
When you configure an action you should determine the default privacy level. People using the app can choose to override that default privacy level with any privacy level that's more restricted, but not more open.
To ensure that all Open Graph stories shared on Facebook are high quality, all apps that want to share stories must go through a review process. Reviews are generally done within three business days.
Actions are the 'verbs' or the things that people can do in your app and publish as stories. Actions are published, retrieved and modified using the Graph API.
Objects are the 'nouns' or targets for actions in your stories. Objects can be used in two different ways: self-hosted (represented by HTML markup on a web page) or created using the Object API.
See our sharing best practices to create the most engaging sharing experience.
Open Graph Stories support internationalization of actions and objects for use in multiple languages.
Open Graph reference documentation.
Stories are composed of actions and objects; Facebook has defined a set of common actions and objects, but you may create your own custom actions and objects.