Open Graph
Connect real world actions and objects in your apps with Open Graph.
Open Graph Overview
The Open Graph lets apps tell stories on Facebook through a structured, strongly typed API.
Getting Started
This tutorial guides you through the key steps to publish your first story with Open Graph.
Actions Reference
For a full list of common actions, please see our actions reference.
Movies and Television
Stories
Using Actions
Actions are the "verbs" or the things that people can do in your app. This guide covers how to use actions from your app.
Using Self-Hosted Objects
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.
Submission Process
All stories published to Facebook require approval. This document covers the process.
Using the Object API
The Object API lets you create and manage Open Graph Objects using a simple HTTP-based API.
Custom
Creating Custom Stories
Sometimes you want to create your own story using your own type of action. This guide walks you through our custom stories creation tool.
Creating Object Types
If you need to build your own type of object, this guide walks you through the process.
Creating Action Types
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.
Guides
Collections
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.
Property Types
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 Places and People
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.
Explicit Sharing
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.
Internationalization
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.
Link Referer Parameters
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.
Insights
This document covers Facebook Insights, which provides developers with metrics around their content.
Cover Feed
For developers, Facebook Home enables new ways to surface your content to help people discover your app and reengage with existing users.
How-Tos
Maximizing Distribution for Media Content
Learn how news sites, magazines, blogs and other media sites can use Facebook tools to create engaging Facebook experiences.
Publishing With an App Token
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.
Objects Without Titles
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.
Posting Past Actions
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
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
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.
Adding Photos to Stories
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.
Updated about a week ago