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


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.


The title, headline or name of the object.


A short description or summary of the object.


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.


The Facebook app ID of the site's app.


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.


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


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.


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.


When the object was last updated.


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


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


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.


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


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


Currently the only content restriction supported is for alcohol.


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.


The Facebook ID of a user that can be followed.


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}">


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

Meta tag Description


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


Secure URL of the audio resource.


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"> 


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 object for an example of Contact Data for standard objects.


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

Meta tag Description


Latitude as represented in decimal degrees format.


Longitude as represented in decimal degrees format.


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">


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


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.


Equivalent to og:image


https:// URL for the image


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


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.


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">


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


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.


Equivalent to og:video


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


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


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


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


Specify an image for a high quality preview in News Feed


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.