Install facebook plugin

The Chat Plugin supports modern popular desktop and mobile browsers except Messenger in-app browsers and Internet Explorer.

To take advantage of internationalization, including automatic language translation, you need to change the locale of the SDK to match the locale of your site. We also provide APIs that allow you to dynamically control certain behaviors of the plugin such as opening and closing the dialog. To include the Chat Plugin on your webpage, you can either use the setup tool or setup using developer steps.

For Page Admins, the Page settings also provides an easy setup tool for customizing your Chat Plugin. To use the setup tool, do the following:. If you need help pasting the code, you can find installation instructions for how to install on top website builders here. For security reasons, the plugin will only render when loaded on a domain that you have whitelisted. IP addresses and localhost are not supported for whitelisting.

Businesses whose Messenger experience is provided by a service provider, will not have access to the page token generator in app settings because they do not own the Facebook app. In this case, you may add or remove whitelisted domains via Page settings. To whitelist a domain, do the following:.

By default, the greeting dialog will be shown on desktop and mobile. We highly suggest not changing the default position of the Chat Plugin from the bottom-right corner of your page. For a complete list of attributes, see the Chat Plugin reference. If the ref attribute is set in the include for the Chat Plugin, it will be included in the postback event.

The ref can be any string and can be used for a variety of purposes. For example, you could use it to keep track of which customers have engaged with your business via the plugin. The Chat Plugin supports the following customizations. There are several ways for developers to apply customization. Customization set via the plugin setup tool under page settings are linked to the Customization API. Developer can specify fields to retrieve. If no fields are specified, all fields will be returned.

We recommend that developers only use this method for customizations that are not available via Page settings setup tool or Customization API. The color to use as a theme for the plugin, including the background color of the Chat Plugin icon and the background color of any messages sent by users. Supports any hexadecimal color code with a leading number sign e. We highly recommend you choose a color that has a high contrast to white.

The greeting text that will be displayed if the user is currently logged in to Facebook. Maximum 80 characters. The greeting text that will be displayed if the user is currently not logged in to Facebook. Sets how the plugin and greeting dialog will be displayed. The following values are supported:. To enable messaging on your Facebook page go to your Page Settings. You can also just add a single tab showing either the timeline , events or messages :.

The plugin will by default adapt to the width of its parent container on page load min. If the width of the parent element is bigger than the Page plugin's width it will maintain the value defined in data-width :. Adaptive width can be switched off by unchecking Adapt to plugin container width and the plugin will rendered at the specified width irrespective of the parent container.

The Page plugin works with responsive, fluid and static layouts. You can use media queries or other methods to set the width of the parent element, yet:. If you want to adjust the plugin's width on window resize, you manually need to rerender the plugin.

Show who likes your Page with real people's profile images rather than just a number. People visting your Page will see a count of friends that like the Page as well as their profile photos.

This option can be activated by checking Show Friend's Faces in the configurator. When you load the SDK, change the value of js. You may need to adjust the width of a Social Plugin to accommodate different languages.

Docs Tools Support. Social Plugins. Page Plugin Embed components of a Facebook Page onto a webpage. Quote Plugin Select text on a Page and add it to a share. Embedded Comments Add public comments into the content of a webpage.

Embedded Posts Add public posts into the content of a webpage. Follow Us. Terms and Policies.