Send Button

The Send button lets people privately send content on your site to one or more friends in a Facebook message, to an email address, or share it with a Facebook group.
URL to send
Width
Height
Color Scheme

Settings

The configurator above doesn't include all of the possible settings for your Send button. You can also change the following settings:
SettingHTML5 AttributeDescriptionDefault
colorschemedata-colorschemeThe color scheme used by the plugin. Can be "light" or "dark"."light"
hrefdata-hrefThe absolute URL of the page that will be sent.Current URL.
kid_directed_sitedata-kid-directed-siteIf your web site or online service, or a portion of your service, is directed to children under 13 you must enable this"false"
refdata-refA label for tracking referrals which must be less than 50 characters, and can contain alphanumeric characters and some punctuation (currently +/=-.:_). See the FAQ for more details.None

FAQ

How can I customize what is shared when people click on a Send Button?

The story created by the action of sending your page can be enriched by using meta tags to turn a simple HTML page into an Open Graph object. If you plan to use the Send button on any page on your website, you should read our best practices guide to ensure published stories look great on Facebook and get the best possible distribution.

How do I know when someone clicked on a Send button on my site?

The Send button allow you to subscribe to the 'message.send' event in the Facebook SDK for JavaScript through FB.Event.subscribe. This JavaScript event will fire any time a button is clicked.

When I click the Send button, the popup window ('flyout') doesn't show. Why?

If the Send button is placed near the edge of an HTML element with the CSS overflow property set tohidden, the flyout may be clipped or completely hidden when the button is clicked. This can be remedied by setting the overflow property to a value other than hidden, such as visiblescroll, orauto.

What analytics are available about the Send button?

If you visit Facebook Insights and register your domain, you can see the number of sends from your domain each day and the demographics of who is clicking the Send button.

How can I track referrals from a Send Button?

The ref setting causes two parameters to be added to the referrer URL when a person clicks a link sent via the Send button:
  • fb_ref - the ref parameter
  • fb_source - the story type ('message', 'group', 'email') in which the click occurred.
For example:
http://www.facebook.com/l.php?fb_ref=top_left&fb_source=message
You can track these parameters using your analytics software.

Why and when does Facebook scrape my page?

Facebook needs to scrape your page to know how to display it around the site. This happens every 24 hours to ensure the properties are up to date. The page is also scraped when the URL is entered into the Debugger Tool.
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.
In some cases you may want to serve a different version of a page to our scraper (containing more Open Graph metadata) than you do to people who are viewing the page. In this case you can target the browser agent used by the scraper:
"facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)"

How do I display the Send button in different languages?

You should include the language code when you instantiate the library. Replace ‘en_US’ in this line with the correct locale code:
'//connect.facebook.net/en_US/all.js';