Open Graph - Object Properties

Open Graph objects contain properties: elements that describe the object in different ways and are represented by Open Graph tags or attributed in objects created using the Object API.

Standard Object Properties

Every object type inherits these standard object properties.

Name Description

og:url

The URL of the object, which acts as the canonical URL. Usually the same URL as the page where property tags are placed. It shouldn't include any session variables, user identifying parameters, or counters. Always use the canonical URL for this tag, or likes and shares will be spread across all of the variations of the URL.

og:title

The title, headline or name of the object.

og:description

A short description or summary of the object.

og:image

The URL of the image for your object. It should be at least 600x315 pixels, but 1200x630 or larger is preferred (up to 5MB). Stay close to a 1.91:1 aspect ratio to avoid cropping. Game icons should be square and at least 600x600 pixels. You can include multiple og:image tags if you have multiple resolutions available. If you update the image after publishing, use a new URL because images are cached based on the URL and might not update otherwise.

fb:app_id

The Facebook app ID of the site's app.

og:type

Find out the type of your object in the Action Type section of App Dashboard. Select the object and find its og:type under Advanced. Once an object is published in a story its type can't be changed.

og:locale

The language locale that object properties use. The default is en_US.

og:video

The URL of a video for the object. If you specify more than one og:video, then og:video:type is required for each video. To make videos play in line, see the video type reference. Videos need an og:image tag to be displayed in News Feed.

og:determiner

The word that appears before the object in a story (such as "an Omelette"). This value should be a string that is a member of the Enum {a, an, the, "", auto}. When 'auto' is selected, Facebook will choose between 'a' or 'an'. Default is blank.

og:updated_time

When the object was last updated.

og:see_also

Used to supply an additional link that shows related content to the object.

og:rich_attachment

When "true", stories published will render with rich metadata such as the title, description, author, site name, and preview image.

og:ttl

Seconds until this page should be re-scraped. Use this to rate limit the Facebook content crawlers. The minimum allowed value is 345600 seconds (4 days); if you set a lower value, the minimum will be used. If you do not include this tag, the ttl will be computed from the "Expires" header returned by your web server, otherwise it will default to 7 days.

og:restrictions:age

An age value of the form [int]+ used to indicate a particular age minimum.

og:restrictions:country

Can be country:allowed or country:disallowed accompanied by a two character country code as specified by the ISO 3166 standard.

og:restrictions:content

Currently the only content restriction supported is for alcohol.

fb:admins

The ID (or comma-separated list for properties that can accept multiple IDs) of an app, person using the app, or Page Graph API object.

fb:profile_id

The Facebook ID of a user that can be followed.

fb:pages

One or more Facebook Page IDs that are associated with a URL in order to enable link editing and instant article publishing.


Complex Object Properties

Complex types are actually different combinations of other simple types that provide rich metadata when used together.

The meta tags listed below are used with standard properties in the following format:

<meta property="{property-name}:{subproperty-name}" content="{value}">

Audio

Use the Audio type for objects that contain audio information like a song or podcast.

Meta tag Description

url

URL of the audio resource. Redundant compared to the simple og:audio form.

secure_url

Secure URL of the audio resource.

type

MIME type of the audio resource.


Example for standard properties:

<meta property="og:audio"              content="http://my-audio.mp3">
<meta property="og:audio:secure_url"   content="https://my-audio.mp3">
<meta property="og:audio:type"         content="audio/mp3"> 

ContactData

Use the ContactData type when defining objects that have a physical location with an address, phone number and other contact info.

Meta tag Description

street_address (string, required)

The number and street of the postal address for this business.

locality (string, required)

The city (or locality) line of the postal address for this business.

postal_code (string, required)

The postcode (or ZIP code) of the postal address for this business.

region (string)

The state (or region) line of the postal address for this business.

country_name (string, required)

The country of the postal address for this business.

email (string)

An email address to contact this business.

phone_number (string)

A telephone number to contact this business.

fax_number (string)

A fax number to contact this business.

website (string)

A website for this business.


See the business.business object for an example of Contact Data for standard objects.

GeoPoint

Use the geopoint complex type when defining objects that specify spatial information (ex: geographic location).

Meta tag Description

latitude

Latitude as represented in decimal degrees format.

longitude

Longitude as represented in decimal degrees format.

altitude

Altitude of location in feet.


Example for standard properties:

<meta property="place:location:latitude"  content="37.416382"> 
<meta property="place:location:longitude" content="-122.152659"> 
<meta property="place:location:altitude"  content="42">

Image

Use this set of properties for content that contains more than one image. See Sharing Best Practices for guidance on how best to use og:image.

Meta tag Description

og:image

URL for the image. To update an image after it's been published, use a new URL for the new image. Images are cached based on the URL and won't be updated unless the URL changes.

og:image:url

Equivalent to og:image

og:image:secure_url

https:// URL for the image

og:image:type

MIME type of the image. One of image/jpeg, image/gif or image/png

og:image:width

Width of image in pixels. Specify height and width for your image to ensure that the image loads properly the first time it's shared.

og:image:height

Height of image in pixels. Specify height and width for your image to ensure that the image loads properly the first time it's shared.


Example for standard properties:

<meta property="og:image"            content="http://food.png">
<meta property="og:image:secure_url" content="https://food.png">
<meta property="og:image:type"       content="image/png">
<meta property="og:image:width"      content="200">
<meta property="og:image:height"     content="500">

Video

You can use og:video for all content types. This section describes how to use additional tags to optimize the look of videos on Facebook. Facebook supports both mp4 and Flash videos.

Use a secure URL for both the og:video:url and og:video:secure_url tags to make your video eligible to play in-line in News Feed. Note that your video is not guaranteed to play in-line based on a variety of factors.

Meta tag Description

og:video

The URL for the video. If you want the video to play in-line in News Feed, you should use the https:// URL if possible.

og:video:url

Equivalent to og:video

og:video:secure_url

Secure URL for the video. Include this even if you set the secure URL in og:video.

og:video:type

MIME type of the video. Either application/x-shockwave-flash or video/mp4.

og:video:width

Width of video in pixels. This property is required for videos.

og:video:height

Height of video in pixels. This property is required for videos.

og:image

Specify an image for a high quality preview in News Feed

Quantity

Use the quantity complex type when defining objects that specify a measurement of a supported type. Once this property is configured to be displayed, we use the specified value and units to display a translated quantity based on people's locales. For example, if you specify length in kilometers, we show the converted value in miles for people with en_us locale.

Meta tag Description

value (float)

The numeric value for the quantity.

units (enum)

The unit type that matches the value. One of Ym, Zm, Em, Pm, Tm, Gm, Mm, km, hm, dam, m, dm, cm, mm, μm, nm, pm, fm, am, zm, ym, Yg, Zg, Eg, Pg, Tg, Gg, Mg, kg, hg, dag, g, dg, cg, mg, μg, ng, pg, fg, ag, zg, yg, Ys, Zs, Es, Ps, Ts, Gs, Ms, ks, hs, das, s, ds, cs, ms, μs, ns, ps, fs, as, zs, ys, YA, ZA, EA, PA, TA, GA, MA, kA, hA, daA, A, dA, cA, mA, μA, nA, pA, fA, aA, zA, yA, YK, ZK, EK, PK, TK, GK, MK, kK, hK, daK, K, dK, cK, mK, μK, nK, pK, fK, aK, zK, yK, Ymol, Zmol, Emol, Pmol, Tmol, Gmol, Mmol, kmol, hmol, damol, mol, dmol, cmol, mmol, μmol, nmol, pmol, fmol, amol, zmol, ymol, Ycd, Zcd, Ecd, Pcd, Tcd, Gcd, Mcd, kcd, hcd, dacd, cd, dcd, ccd, mcd, μcd, ncd, pcd, fcd, acd, zcd, ycd, mi, ft, in, ton, lb or oz.