Open Graph
Help people tell rich stories on Facebook from your app through a structured, strongly typed API.
Open Graph Overview
Open Graph lets you integrate apps deeply into the Facebook experience, which increases engagement, distribution and growth.
Actions Reference
For a full list of common actions, please see our actions reference.
| Music |
| Movies and Television | |
| Books |
| Fitness | |
| General |
Stories
Using ActionsActions 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 ObjectsObjects 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. | Using the Object APIThe Object API lets you create and manage Open Graph Objects using a simple HTTP-based API. |
Submission ProcessAll stories published to Facebook require approval. This document covers the process. |
Custom
Creating Custom StoriesSometimes 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 TypesIf you need to build your own type of object, this guide walks you through the process. | Using the Object APIThe Object API lets you create and manage Open Graph Objects using a simple HTTP-based API. |
Creating Action TypesThe 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
CollectionsCollections 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 TypesOpen 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 PeopleTagging 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 SharingWhen 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. | InternationalizationApps 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 ParametersWhen 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. |
InsightsThis document covers Facebook Insights, which provides developers with metrics around their content. |
How-Tos
Maximizing Distribution for Media ContentLearn how news sites, magazines, blogs and other media sites can use Facebook tools to create engaging Facebook experiences. | Publishing With an App TokenIf 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 TitlesSometimes 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 ActionsWith 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 RestrictionsUser 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 linksAction 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 StoriesWith 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. | Using Canonical URLs For Self-Hosted Objects On Mobile Web AppsWeb Apps which use subdomains for mobile-optimised versions can avoid adding extra metadata to the mobile views of their self-hosted objects, by using canonical URLs pointing to the desktop view of the same objects. | Optimizing Metadata On Self-Hosted Objects Using PointersWeb apps with large amounts of OG metadata describing their self-hosted objects can find performance benefits by serving the metadata from a separate URL, linked from the canonical object URL. |
Updated on Wednesday