The Open Graph lets apps tell stories on Facebook through a structured, strongly typed API.
This tutorial guides you through the key steps to publish your first story with Open Graph.
For a full list of common actions, please see our actions reference.
Actions are the "verbs" or the things that people can do in your app. This guide covers how to use actions from your app.
Objects are the "nouns" or targets for actions taken by people in your app. This guide covers how to create common objects based on Facebook's common object types.
All stories published to Facebook require approval. This document covers the process.
The Object API lets you create and manage Open Graph Objects using a simple HTTP-based API.
Sometimes you want to create your own story using your own type of action. This guide walks you through our custom stories creation tool.
If you need to build your own type of object, this guide walks you through the process.
The easiest way to create your own types of actions is via our custom stories tool, but you can also create a new action type directly as well.
Collections are a way for people to highlight the things that they care about, the places they've been or the things they've done. This guide covers how actions interact with collections and how you can create your own custom collections.
Open Graph objects contain properties: elements that describe the object in different ways and are represented by meta tags included on the object page. This document shows you all the property types that can be used.
Tagging is a great way to create rich Open Graph stories that highlight friends and places. This guide shows you how to tag and mention various people and pages.
When a person wants to share something on Facebook from your app, you need to add parameters to your action to indicate the person's intent. This guide covers both how to use explicit sharing as well as guidance on how to express the intent to share in your app.
Apps can publish their actions and objects with Open Graph in order to help drive distribution of their apps. These actions and objects can be localized to various languages.
When someone is sent to your site from an Open Graph story, information is passed about what generated the story. This is the list of parameters.
Learn how news sites, magazines, blogs and other media sites can use Facebook tools to create engaging Facebook experiences.
If your app publishes on behalf of its users and requires an access token with no expiration time for the purpose of publishing, you should use an App Access Token.
Sometimes objects do not have meaningful titles. For example, users often do not title photos. To avoid having to add meaningless titles, Open Graph supports objects that have no title.
With Open Graph, people using your app can choose to have both their present and past activities published to their timelines. For actions that occurred in the past, people can add past information from your app to the correct point on their timelines.
User restrictions can be applied to Open Graph stories to make the content available to approved audiences. News Feed, ticker and timeline stories can be filtered by country, age and content.
Action links are custom links added to the bottom of Open Graph stories in the News Feed or on the timeline. They let friends quickly take action in response to something without having to navigate away from that story.
With an increasing number of people having access to cameras on mobile devices, there is a growing need to share photos in Open Graph stories. Photo-generating apps can utilize the user_generated photos capability to enhance these stories with a larger display in News Feeds and on timelines.