135

I have seen conflicting information on how to best implement Open Graph namespaces. Specifically, the Open Graph website uses a few different methods, and the Facebook Open Graph examples use other methods.

Open Graph website example (using HTML prefix attribute):

<html prefix="og: http://ogp.me/ns#">

Open Graph website source code (using HTML XMLNS attribute):

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:og="http://ogp.me/ns#">

Facebook Open Graph documentation (using HEAD prefix attribute):

<head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb#">

Facebook Open Graph documentation #2 (using HTML XMLNS attribute):

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:og="http://ogp.me/ns#" 
      xmlns:fb="https://www.facebook.com/2008/fbml">

What is the recommended method or does it not even matter?

4

5 Answers 5

76

They are all equivalent and will all work.

Use prefix as it is the new recommended way and is fewer characters.

I'll get all our documentation updated to prefix.

8
  • 4
    Can you explain why to use anything at all? How about I just leave off this declaration? is anything going to break if I do that?
    – andrewrk
    Apr 13, 2012 at 17:24
  • 3
    Nothing will break right now, but relying on defaults is rarely a good idea when you can be explicit. If 2 years down the road we change the defaults, your site will break. Also, if you declare your namespaces directly it will help other parsers not just Facebook. Apr 18, 2012 at 11:05
  • 1
    Paul, I have noticed that the docs haven't been updated since November. Why is using the new way best, if both ways will be supported by all existing browsers for the foreseeable future? Adopting something new if support is not all there (among user agents, parsers, etc.) seems like an unnecessary risk unless there is some actual difference between the two. I haven't been able to find any resource that says so.
    – AndrewF
    Apr 28, 2012 at 3:24
  • 3
    @PaulTarjan Here! That one has an example using xmlns. Also, should the prefix be used on html or head tag? Would it be fine either way? Which is recommended?
    – its_me
    Aug 16, 2012 at 12:55
  • 9
    Oh, those docs are old. The yellow thing at the top says so. We didn't want to touch them because they are referenced a lot. Put the prefix on the head. It works on both but closer to the tags is better. Aug 17, 2012 at 23:42
5

I tried following @Paul Tarjan's answer of using prefix in the head. However I got some Internet Explorer 8 issue. So in the end I still use the xmlns way for fb namespace:

<!DOCTYPE HTML>
<html xmlns:fb="http://ogp.me/ns/fb#">
  <head prefix="og: http://ogp.me/ns# object: http://ogp.me/ns/object#">
5

It doesn't even matter. RDFa Core Initial Context recognizes og as a widely used vocabulary prefix:

RDFa users can use these prefixes without having the obligation of defining the prefixes in the HTML code. The same list of prefixes have also been defined for JSON-LD as a JSON-LD Context at the URI http://www.w3.org/2013/json-ld-context/rdfa11; JSON-LD users can use the @context key with that URI as a shorthand to use the same prefixes.

Emphasis added for clarity.

Therefore, you do not need to add a namespace to your HTML documents. More information here.

0
2
<html xmlns="http://www.w3.org/1999/xhtml" prefix="og: http://ogp.me/ns# fb:
http://www.facebook.com/2008/fbml"> <head>

There is the best way to validate.

1

prefix/xmlns attribute is useful to define short-hand. rdf is from xml lineage so xmlns notation should be expected to work independent of doctype detail. rdfa extends html with attributes including prefix as given by http://www.w3.org/TR/rdfa-in-html/#extensions-to-the-html5-syntax However, this requires adhering to http://dev.w3.org/html5/rdfa/rdfa-module.html Also, the tool support for rel="profile" as mentioned therein is as yet awaited. Till then, the choice is between using older doctypes, or manually placing rdf: for validation purpose or wait for validator & such tools to catch-up. The right place to make declaration is any element opening tag which is ancestor of wherever the short-hand notation will be used. Specifically for the case of og prefix, its predefined by the initial context of RDFa Core http://www.w3.org/2011/rdfa-context/rdfa-1.1.html so skipping it altogether for newer doctypes is alright. And specifically for html5 the RDFa initial context http://www.w3.org/2011/rdfa-context/html-rdfa-1.1 is loaded only after the RDFa initial context mentioned earlier.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.