This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



The Facebook plugin for WordPress adds Facebook social plugins to your WordPress site. Associate your WordPress site with a free Facebook application identifier to enable advanced features such as automatically sharing new posts to an author’s Facebook Timeline or your site’s Facebook Page. This plugin is developed by Facebook with extra support for popular plugins and themes, custom post types, and custom post statuses.


  • Open Graph protocol markup optimizes your content for social sharing and rich story previews on Facebook, Twitter, Google+, Mixi, and more. Display large images, link to author pages, and improve story distribution through social news feeds.
  • Facebook Insights support for Facebook accounts associated with a Facebook application. Track rich audience data powered by Facebook profiles (age, location, language) and see how your content is shared on Facebook.
  • Add Like, send, and follow buttons to every post to help your site’s readers share content with friends or stay connected to future content shared by your site and its authors on Facebook.
  • Embed Facebook Posts by pasting a URL into your post composer, creating a shortcode, or calling a function from your theme.
  • Enable the Facebook Comments Box social plugin to encourage new comments from logged-in Facebook users and his or her Facebook friends. Comments associated with a post are sorted according to social signals including friend networks, most liked, or the most active discussion threads. Advanced features include moderation, blacklisted words, automatic grammar correction, and login support for AOL, Microsoft, and Yahoo! accounts.
  • Like Box displays recent activity from your Facebook Page and encourages new Like actions.
  • Recommendations Bar helps visitors discover additional content on your site by recommending posts and encouraging Like shares.
  • Recommendations Box suggests related posts in a configurable widget.
  • Configure your Facebook application for Open Graph action news publishing support for improved Facebook distribution of author Timeline stories and news-specific highlights.
  • Mention Facebook friends and Facebook pages in a custom message posted to your Timeline with your post.
  • Customize and extend the plugin through custom actions and filters.


Add a Like Button, Send Button, Follow Button, or Embedded Posts using a shortcode inside your post or evaluated from within your theme. You may override site-level options with shortcode attributes defined on the social plugin’s page.

  • [facebook_like_button]
  • [facebook_send_button]
  • [facebook_follow_button href="{$facebook_profile_url}"]
  • [facebook_embedded_post href="{$facebook_post_url}"]

Contributing code

The development source code for this plugin is available on Facebook’s GitHub account. Pull Requests and code discussion welcome.

Custom actions & filters


  • facebook_settings_before_header_$hook_suffix – add content to a settings page before the main page header section
  • facebook_settings_after_header_$hook_suffix – add content to a settings page after the main page header section
  • facebook_settings_footer_$hook_suffix – add content to a settings page below the wrapper div
  • facebook_comment_form_before – comment form pluggable action replacing the WordPress comment_form() equivalent action comment_form_before
  • facebook_comment_form_after – comment form pluggable action replacing the WordPress comment_form() equivalent action comment_form_after


  • facebook_features – limit the plugin features available on your site
  • facebook_jssdk_init_options – customize arguments sent to the FB.init function of the Facebook JavaScript SDK
  • facebook_jssdk_init_extras – add extra JavaScript to the fbAsyncInit JavaScript function called after the Facebook JavaScript SDK is loaded
  • facebook_content_filter_priority – choose the priority of Facebook social plugin filters attached to the_content filter. Affects where Facebook content is output on your page relative to other plugins attached to the_content
  • fb_locale – directly define your site locale based on the list of Facebook locale mappings
  • facebook_excerpt_length – choose a custom length, in words, of a post excerpt generated for use in the Open Graph protocol description. default: 55
  • facebook_excerpt_more – string appearing at the end of a truncated excerpt string. default: “…”
  • fb_rel_canonical – customize the canonical URL used by Facebook for a post. Affects Open Graph protocol URL definitions, URL references sent in Open Graph actions, and more. default: result of get_permalink()
  • facebook_comment_schema_org – override output of search engine friendly comments content using microdata markup
  • facebook_comments_number_more – override the default “% Comments” text used to generate a client-side comments number. similar to WordPress’ comments_number more parameter
  • facebook_og_type – set an Open Graph object type for a specific post early in the Open Graph process. Affects Open Graph protocol properties built with the page and later passed to fb_meta_tags. Affects Open Graph action publishing: only an article may be published to a Facebook Timeline using the news.publishes action
  • fb_meta_tags – Customize Open Graph protocol markup before it is output to the page
  • facebook_ogp_prefixed – true to always use prefixed properties (og:title) or false to use full IRI properties (
  • facebook_rdfa_mappings – array of RDFa references with desired prefix. Used to remap Open Graph protocol properties from a full IRI to a prefix
  • facebook_wp_comments_title – set a custom title for the Facebook comments template
  • facebook_wp_list_comments – customize the arguments sent to wp_list_comments for display of WordPress comments inside the Facebook comments template
  • facebook_comments_wrapper – override the display of Facebook comments fetched from Facebook servers for display on the page. default: noscript. set to an empty string to prevent fetch and inclusion
  • fb_get_user_meta – fetch a user meta value by attaching to this filter, bypassing the WordPress user meta API
  • fb_update_user_meta – update a user meta value by attaching to this filter, bypassing the WordPress user meta API
  • fb_delete_user_meta – delete a user meta value by attaching to this filter, bypassing the WordPress user meta API


  • Facebook settings screen
  • Mention Facebook friends and pages in a custom message posted to your Timeline
  • Create a custom message published to your Facebook Timeline or Page alongside a summary of your new post
  • The resulting post published on the author's Timeline
  • Encourage social activity by adding Facebook social plugins before and after your posts
  • Facebook social plugins are available as WordPress widgets
  • Customized Like Box and Recommendations Box social plugins displayed as WordPress widgets
  • Facebook Insights showing demographics for your domain


  1. Install Facebook for WordPress either via the plugin directory, or by uploading the files to your server (in the /wp-content/plugins/ directory).
  2. You should be able to start using social plugins (Like Button, Send Button, etc.) right away.
  3. After activating the plugin, you will be asked to set up your Facebook application or enter existing credentials copied from the Facebook Developers site to unlock additional features such as publishing posts to an author Timeline or site Page.
  4. Optionally set up a Facebook Open Graph action with user message, mentions tagging, and explicitly shared action capabilities. See the Facebook for WordPress help page for more information.
  5. That’s it. You’re ready to go!


Installation Instructions
  1. Install Facebook for WordPress either via the plugin directory, or by uploading the files to your server (in the /wp-content/plugins/ directory).
  2. You should be able to start using social plugins (Like Button, Send Button, etc.) right away.
  3. After activating the plugin, you will be asked to set up your Facebook application or enter existing credentials copied from the Facebook Developers site to unlock additional features such as publishing posts to an author Timeline or site Page.
  4. Optionally set up a Facebook Open Graph action with user message, mentions tagging, and explicitly shared action capabilities. See the Facebook for WordPress help page for more information.
  5. That’s it. You’re ready to go!
How do I sign up for a Facebook application ID for my website?

You may create a new Facebook application or edit your existing Facebook application through the Facebook Developers application interface. You may first need to signup for a Facebook Developer account.

I am unable to save my Facebook application ID and secret

Some webmasters have reported issues saving Facebook application ID and secret information in the Facebook settings page. These inputted values are verified with Facebook servers before saving, requiring an HTTPS request to Facebook servers. Some sites experiencing issues have identified their server’s bundled SSL certificates as an issue; returning false for the https_ssl_verify filter used by the WordPress HTTP class may help fix server-to-server communication issues if updating your cURL or other libraries is not an option.

How do I change the image that appears for my posts shared on Facebook?

The plugin generates Open Graph protocol markup for your site’s webpages including a explicitly-specified images generated from the post thumbnail, attached images, or gallery shortcode. Your plugin or theme may define additional images through the fb_meta_tags filter. If an image or images already exists your additional image may be used as an alternate for stories shared through a pasted link. Unattended story summaries such as a Like Button click use the first defined image. support sticky

I do not like the summary of my posts shared to Facebook

Facebook generates a story summary for pasted links and new posts sent to your Timeline or Page based on metadata found on your page. The Facebook plugin for WordPress generates Open Graph protocol metadata to assist Facebook’s understanding of your webpages. The Facebook URL debugger provides a view into Facebook’s representation of your webpage and relevant extracted metadata. Test URLs of interest in the debugger to better understand how your page might be represented on Facebook.

I do not see an option to associate my Facebook account from my WordPress profile page

Make sure your Facebook application is properly configured for Facebook Login including the correct app domain and website URL. The Facebook debug settings submenu item in your WordPress administrative interface highlights some common issues.

How do I moderate comments and add reviewers?

The Comment Moderation Tool allows you to customize your Facebook application’s moderators, blacklisted words, external logins, and more.

Does Facebook Comments work with my existing WordPress comments?

The Comments Box social plugin is meant to replace the WordPress commenting system with a more social, client-side experience. We do not currently support synchronizing comments stored on Facebook with comments stored in your WordPress database. Posts with existing WordPress comments will display those comments followed by the Facebook Comments Box.

Why do comments on a post published to my Facebook Timeline or Page not appear inside Facebook Comments Box on my post page?

The Facebook Comments Box social plugin is a separate commenting system associated with a URL regardless of your authors’ decision to post to his or her Facebook Timeline or your site’s Facebook Page.

What additional configuration steps do I need to complete to enable an Open Graph action for my Facebook application?

Visit the Facebook plugin for WordPress getting started page for more details and screenshots of each step in the process. You will need to create an Open Graph action-object pair for your Facebook application: publish an article. You will need to submit the new publish action for approval with support for action capabilities allowing custom messages on an author’s Timeline, mentioning Facebook friends and Facebook pages within that message, and marking the new post as explicitly shared.

I set up my social plugin but nothing happened

Some social plugins require a URL representing a specific Facebook feature: the Follow button accepts a person’s Timeline URL; the Like Box accepts a Page URL. Try configuring similar parameters through the appropriate Facebook social plugins page to view a preview of what to expect on your WordPress site after a successful configuration.

My site content is Spanish. Why does Facebook display social plugin text in English?

The Facebook plugin for WordPress examines your WordPress locale and chooses the most appropriate match from a list of Facebook locales. You can act directly on the fb_locale filter for more exact control.

It’s possible another plugin (or your theme) including an English version of the Facebook JavaScript SDK before the Facebook plugin for WordPress tried to include the Spanish version of the same SDK. View source on the affected page and search for “” to locate multiple possible attempts to load the Facebook JavaScript SDK.



Multi billion dollar company cant keep a plugin updated? Typical

Plugin deprecated

The plugin is deprecated with the release of Graph API v2.3 or earlier.

The plugin is no longer officially supported by Facebook and not maintained by the developer community.

DO NOT INSTALL – it will crash your WD framework.

Read here …

500 error

After installing the facebook plugin, my website showed a 500 error. I had to go to ftp and manually delete the folder.

Read all 264 reviews

Contributors & Developers

“Facebook” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Facebook” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Update Facebook SDK for PHP app secret proof and signed request handling
  • Add empty directory index files to prevent autoindex files and exposed server directories
  • Replace deprecated $wpdb->escape() with esc_sql()
  • Link to App Insights 2.0
  • Remove widget title escaping, allowing HTML titles


  • Facebook Like Button supports the new Share button
  • Add Facebook Embedded Post custom width support through shortcode
  • Removed channelUrl Facebook JavaScript SDK initialization parameter
  • Facebook SDK for PHP 3.2.3


  • Delete Facebook account data associated with a WordPress user from the user profile screen.
  • Facebook application data for Facebook Login displayed in the settings debug screen.
  • Improve social publisher compatibility with scheduled posts.
  • (beta) Convert Instagram embeds to og:images. Convert YouTube and Vimeo embeds to Open Graph media objects for video post formats.
  • Improved code documentation.


  • Generate and store an app secret proof for Facebook Page access token verification


  • Expand Open Graph protocol markup to all singular post types
  • Generate and store an app secret proof on Facebook app id and app secret verification
  • Support auto embed of Facebook notes URLs


  • Rewritten administrative tools to associate a WordPress user with a Facebook account from a profile settings page and a Facebook Page with a WordPress site from the Facebook Social Publisher settings page
  • Improved Open Graph protocol markup for image, video, and audio post formats
  • Improved auto-discovery of post images for use as Open Graph protocol images
  • Added support for Facebook Embedded Posts
  • Custom dashicon font adds resolution-independent graphics to your administrative interface
  • Updated Facebook SDK for JavaScript asynchronous loading snippet
  • Added enhanced privacy mode for Facebook SDK for JavaScript for sites targeting children in the United States under the age of 13


  • Facebook Comment API update to support July 2013 changes
  • Improved reliability of Facebook application credentials verification for app access token exchange
  • The get_comments_number function response now includes the number of comments for a post stored on Facebook servers
  • Update Facebook PHP SDK. Includes support for app secret proofs
  • Fix typo preventing custom classes on social plugins
  • New Facebook icons matching April 2013 Facebook favicon redesign
  • Added support for shortcode filters (WordPress 3.6+)


  • Reject new comments submitted for a post with comments managed by Facebook Comments Box
  • Improve Facebook PHP SDK performance through WordPress-managed sessions
  • Faster image display for mention tagging autocomplete


  • Open Graph posting is now an advanced feature configured through a site’s Social Publisher settings page. Applications without an approved Publish action can post to an author’s Timeline feed with more limited functionality and story promotion.
  • Comments Box moved to comments_template, overriding your theme’s default comments template. Existing WordPress comments are displayed above the Comments Box.
  • Added ability to disable fetching Facebook comments from Facebook servers for inclusion on the page inside a noscript element for improved SEO. See the facebook_comments_wrapper filter for more details.
  • Set a custom sort order for Comments Box comments: social, chronological, or reverse chronological.
  • Do not fetch Facebook user status or set a site cookie for default Facebook JavaScript SDK loads on the site frontend.


  • Post to Facebook Page using Facebook application access token
  • Do not display social publisher meta boxes or publish flow if post type not explicitly public
  • Improved local validators for publish flow


  • Improve performance of settings migration from old versions of the plugin


  • Fix: Properly display Open Graph protocol data on author page


  • Post to Timeline now uses an app access token to communicate with Facebook servers without needing an active Facebook user session. Improves XML-RPC compatibility and wp-admin performance
  • The Facebook PHP SDK is now loaded as needed, not with every admin request
  • Mention tagging Facebook friends and Facebook pages replaces previous mention meta boxes for friends and pages
  • Removed mention display alongside a post. Mentions are constructed in a custom Facebook message
  • Associate a WordPress account with a Facebook account from the edit profile page


  • Added Like Box widget for Facebook Page promotion
  • New locale selector provides more extensible code
  • Social publisher settings page inline help
  • Fixed bug publishing to a Facebook Page


  • Do not compare strings when needle longer than haystack
  • Test if expected widget files and classes exist before registering a widget. Fixes possible cache conflict


  • Support social action tracking in Google Analytics. Includes Google Analyticator and Google Analytics for WordPress support
  • Facebook Subscribe Button is now known as Follow Button
  • Add gallery images to Open Graph protocol images array if gallery shortcode present
  • Update to Facebook PHP SDK 3.2.2
  • WordPress 3.5 color picker support in Recommendations Box and Activity Feed plugins
  • Fix incorrectly referenced admin menu icon file locations in minified version of icons.css


  • Bugfix: use the post global object instead of get_post on a comments filter


  • Comments Box – overrides of WordPress comment system applied at the post level, allowing more fine-grained control of comments by post type or mixed in a single loop
  • Comments Box – declare post author with moderate_comments capability an admin of the individual page, granting comment moderation capabilities on Facebook for the post
  • Hide settings error display if function is not yet defined


  • Open Graph protocol data output in prefixed form (e.g. og:title) instead of full IRI. You may declare your preference to always use a prefix in the future using the facebook_ogp_prefixed filter
  • Debug page displays your plugin configuration, author accounts associated with a Facebook account, and server information for troubleshooting
  • Shortcode support for Like Button and Send Button output
  • Comments Box may be disabled for a specific post when post comments are marked closed in WordPress and no comments are stored on Facebook
  • Application id and secret are verified on Facebook servers, generating an app access token for future use
  • Async JavaScript loader support for concatenated script loader configurations
  • Fixed an issue with Comments Box color scheme preference never saving a “dark” preference value
  • JavaScript files renamed to .js and .min.js to match WP Core 3.5 convention (see Core #21633 )
  • Includes Facebook PHP SDK 3.2.1 and its new SSL certificate chain fallback


  • Delete comments enabled option on plugin’s settings comments page save when no comments selected.


  • Comment counts powered by Facebook available in all page contexts when comments box social plugin enabled for one or more post types
  • Subscribe button settings fix
  • Recommendations Bar max age setting fix


  • PHP issue affecting 5.2.4 – 5.2.8 installs
  • Properly save number of articles setting for recommendations bar
  • Add explicit Open Graph protocol URL for front page and home


  • Improve PHP 5.2 compatibility
  • Fix minimum number of seconds before recommendations bar shown
  • properly reference widget ids for stats


  • Supports public custom post types and custom post status
  • Facebook JavaScript SDK loads asynchronously after pageload
  • Settings page broken into multiple settings pages with WordPress Settings API support
  • Choose to display social plugins and mentions on your homepage, archive pages, or individual post types
  • Comments markup appearing in noscript wrappers now include comment markup by default
  • Added threaded comment support for noscript fallback markup
  • Updated Facebook PHP SDK to version 3.2
  • New social plugins builder helps correct mistakes before they happen and only include markup on your pages capable of interpretation by the Facebook JavaScript SDK
  • Mention links open in a new browsing context by default
  • Post mentions are displayed inside their meta boxes after save
  • Strings pass through translation functions, opening up future translation support
  • Fixed mixed-content warnings thrown when Facebook images displayed on a page
  • Uninstall script removes site and user options when the plugin is uninstalled through the WordPress administrative interface
  • Contextual help menus display helpful information alongside settings choices
  • High-DPI icon support for administration menu


  • Fixed issue where some sites were extremely slow as a result of installing the plugin (due to cURL not being installed).
  • Added warning and actively disable portions of the plugin if SSL not installed.
  • Fixed bug in social publishing.
  • Added logic to disable meta boxes/publishing if social publishing is disabled.
  • Fixed forever loading issue on FB settings page if no active user exists.
  • Added proper escaping.
  • Added global settings to set whether social plugins show on all posts, all pages, both, or neither. Done for like button, subscribe button, send button, comments, and recommendations bar.
  • Added per-post/page settings for showing/hiding social plugins.
  • Fixed poorly formatted description that was being set when publishing to friends’ and Pages’ feeds.
  • Added notification if plugins that are potentially conflicting are installed.
  • Added suggestions for what to enter in fields in the new user experience.
  • Bug fixes to ensure everything works on mobile (including support for WPTouch).
  • Bug fixes to Pages drop down on the Facebook settings page.
  • Removed the need to create PHP sessions, relying on user meta/transients now.


  • Comment count bug fix.
  • Comments width bug fix.
  • Like, send, subscribe: fixed incorrect hrefs for homepage buttons.
  • Added like/send button to settings page (spread the word!).
  • Changed minimum and maximum supported WP versions.
  • Security fix in the admin control panel.
  • Fixed issue with publishing a post/page if there isn’t a thumbnail defined.
  • Changed auto-completes to play nice with UTF-8.
  • Moved extended access token function to Facebook_WP class.
  • Added debug link on settings page that outputs debug information.
  • Lots of i18n fixes.
  • Added easier debugging of Facebook API errors.
  • Added better logged in state detection in admin UI, depending on if the user has authenticated and given certain permissions.
  • Fixed publishing a post if no friends or pages mentioned.
  • Theme fixes to prevent like and mentions bar from showing up in the wrong place.
  • Fixed configure link on plugins page.
  • Fixes for bugs happening on 404 page.
  • Bug fix for if a WP admin removes the app via
  • Added status messages for what was/wasn’t posted to Facebook as part of a Post/Page being taken live.
  • Added functionality to disable publishing to a page if access token fails.
  • Clearer error messages for certain scenarios (like inability to post to a friend of page’s Timeline because of privacy settings.
  • Fixed conflicts with Power Editor and extraneous text being added to og:description. Thanks to Angelo Mandato (support mention)


  • Launch.