web.archive.org
Docs
Tools
Support
News
Apps
Log In
Social Plugins
Facebook Login
Open Graph
Overview
Getting Started
Facebook APIs
Games
Media
Payments
App Center
Promote Your App
iOS
Android
Web
Technology Partners
Open Graph
Connect real world actions and objects in your apps.
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.
Actions Reference
For a full list of common actions, please see our actions reference.
Music
Listen - Reference | Guide
Create a Playlist - Reference | Guide
Movies and Television
Watch - Reference | Guide
Rate - Reference | Guide
Wants to Watch - Reference | Guide
Books
Rate - Reference | Guide
Read - Reference | Guide
Quote - Reference | Guide
Wants to Read - Reference | Guide
Fitness
Bike - Reference | Guide
Walk - Reference | Guide
General
Like - Reference | Guide
Follow - Reference | Guide
Stories
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.
The Object API lets you create and manage Open Graph Objects using a simple HTTP-based API.
All stories published to Facebook require approval. This document covers the process.
The most important things you should know before submitting your stories for approval.
Custom
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 Object API lets you create and manage Open Graph Objects using a simple HTTP-based API.
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 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.
This document covers Facebook Insights, which provides developers with metrics around their content.
How-Tos
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.
Web 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.
Web 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 15 minutes ago
Facebook © 2013 · English (US)
About​Advertising​Careers​Platform PoliciesPrivacy Policy
Wayback Machine home page1,214 capturesJUNAUG12:08:11 Jun 02, 201302:26:33 Aug 09, 201320122014👤 screenshot▾ About this captureIT History SocietyIT Historical Resource Sites