href— the URL to like. The XFBML version defaults to the current page.
layout— there are three options.
standard— displays social text to the right of the button and friends’ profile photos below. Minimum width: 225 pixels. Default width: 450 pixels. Height: 35 pixels (without photos) or 80 pixels (with photos).
button_count— displays the total number of likes to the right of the button. Minimum width: 90 pixels. Default width: 90 pixels. Height: 20 pixels.
box_count— displays the total number of likes above the button. Minimum width: 55 pixels. Default width: 55 pixels. Height: 65 pixels.
show_faces— specifies whether to display profile photos below the button (standard layout only)
width— the width of the Like button.
action— the verb to display on the button. Options: ‘like’, ‘recommend’
font— the font to display in the button. Options: ‘arial’, ‘lucida grande’, ‘segoe ui’, ‘tahoma’, ‘trebuchet ms’, ‘verdana’
colorscheme— the color scheme for the like button. Options: ‘light’, ‘dark’
ref— a label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_). The ref attribute causes two parameters to be added to the referrer URL when a user clicks a link from a stream story about a Like action:
fb_ref— the ref parameter
fb_source— the stream type (‘home’, ‘profile’, ‘search’, ‘other’) in which the click occurred and the story type (‘oneline’ or ‘multiline’), concatenated with an underscore.
Open Graph Tags
Open Graph tags are
<meta> tags that you add to the
<head> of your website to describe the entity your page represents, whether it is a band, restaurant, blog, or something else.
An Open Graph tag looks like this:
<meta property="og:tag name" content="tag value"/>
If you use Open Graph tags, the following six are required:
og:title— The title of the entity.
og:type— The type of entity. You must select a type from the list of Open Graph types.
og:image— The URL to an image that represents the entity. Images must be at least 50 pixels by 50 pixels. Square images work best, but you are allowed to use images up to three times as wide as they are tall.
og:url— The canonical, permanent URL of the page representing the entity. When you use Open Graph tags, the Like button posts a link to the og:url instead of the URL in the Like button code.
og:site_name— A human-readable name for your site, e.g., «IMDb».
fb:app_id— A comma-separated list of either the Facebook IDs of page administrators or a Facebook Platform application ID. At a minimum, include only your own Facebook ID.
More information on Open Graph tags and details on Administering your page can be found on the Open Graph protocol documentation .
How do I know when a user clicks a Like button?
If you are using the XFBML version of the button, you can subscribe to the ‘edge.create’ event through FB.Event.subscribe.
When will users have the option to add a comment to the like?
If you are using the XFBML version of the Like button, users will always have the option to add a comment. If you are using the Iframe version of the button, users will have the option to comments if you are using the ‘standard’ layout with a width of at least 400 pixels. If users do add a comment, the story published back to Facebook is given more prominence.
What analytics are available about the Like button?
If you visit facebook.com/insights and register your domain, you can see the number of likes on your domain each day and the demographics of who is clicking the Like button.
Can I link the Like button to my Facebook page?
Yes. Simply specify the URL of your Facebook page in the
href parameter of the button.
What is the best way to know which Like button on my page generated the traffic?
Add the ‘ref’ parameter to the plugin (see «Attributes» above).
When a user clicks a link back to your website, we will pass back both the ref value as a fb_ref parameter and the fb_source parameter in the referrer URL. Example:
Aggregated stream stories contain all ref parameters, concatenated with commas.
When does Facebook scrape my page?
Facebook needs to scrape your page to know how to display it around the site.
Facebook scrapes your page every 24 hours to ensure the properties are up to date. The page is also scraped when an admin for the Open Graph page clicks the Like button and when the URL is entered into the Facebook URL Linter. Facebook observes cache headers on your URLs — it will look at «Expires» and «Cache-Control» in order of preference. However, even if you specify a longer time, Facebook will scrape your page every 24 hours.
The user agent of the scraper is: «facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)»
How do I display the Like button in different languages?
If you are using the XFBML version include the language code when you instantiate the library. Replace ‘en_US’ in this line with the correct locale code:
If you are using the Iframe version include a locale parameter with the proper country code in the src URL. Example:
You may need to adjust the width of the Like button to accommodate different languages.
The Like button is replacing ad units or Flash, what should I do?
By using the Like Button, you agree to the general guidelines and terms found here. You also agree that you will not modify the Like Button in any way beyond the customization options provided on this page.