Facebook Social Plugins

This work is licensed under CC BY-SA 4.0

Configuration Guide

Facebook Social Plugins are widgets provided by Meta that website operators can embed to display Facebook content or enable sharing, following, and page promotion directly on third-party websites. Most plugins are loaded via the Facebook JavaScript SDK (connect.facebook.net), which establishes a connection to Meta's servers and may set cookies on the visitor's browser. Meta discontinued the Facebook Like button and Facebook Comment button plugins on 10 February 2026, so this guide covers the social plugins that remain available: the Share Button, Follow Button, Page Plugin, and Embedded Posts/Videos. Under the CJEU's Fashion ID ruling, a website operator that embeds a Facebook social plugin is considered a joint controller together with Meta for the collection and transmission stage of the data processing, even where the operator has no access to the data once it reaches Meta. The configurations below cover the most privacy-relevant implementation choices and their corresponding mappings in the Consenter Manager (CM).


Step 1 β€” Facebook Social Plugin Configuration

#Configuration AreaWhere in Meta for DevelopersConfiguration A β€” Low RiskConfiguration B β€” Medium RiskConfiguration C β€” Higher Risk
1Implementation methodEmbed codePlain hyperlink to Facebook's share dialogue (facebook.com/sharer/sharer.php?u=...); no SDK, no fb-root, no iframe loaded on your pageOfficial Share Button or Follow Button plugin via Facebook JavaScript SDK (fb-root + connect.facebook.net/sdk.js), loaded only after consentPage Plugin and/or Embedded Posts/Videos via Facebook JavaScript SDK, loaded after consent; multiple plugin instances on the same page
2Consent gatingConsent Management / website implementationNot applicable β€” no connection to Meta is made until the visitor actively clicks the link and is redirected to facebook.comRequired β€” SDK only loads for visitors who have consented via the consent bannerRequired β€” SDK only loads for visitors who have consented via the consent banner
3Friend facepile / account-linked displayPage Plugin attribute data-show-facepileNot applicableDisabledEnabled (data-show-facepile="true") β€” shows real profile photos of the visitor's Facebook friends who like the Page, if the visitor is logged into Facebook
4Cookies set on loadMeta Cookies PolicyNone set by the embed itself; cookies are only set if the visitor proceeds to facebook.comSecurity/functional cookie (datr), used to identify the browser independent of login state, persistent for approximately 2 yearsSecurity cookie (datr, ~2 years) and advertising-related cookie (fr, ~90 days), the latter used for ad measurement and cross-site recognition
5Data transmitted regardless of interactionInherent to plugin design (CJEU Fashion ID)None β€” IP address and browser data are only sent if the visitor clicks through to FacebookIP address, browser string, and referring page URL are transmitted to Meta for every consenting visitor upon page load, whether or not they interact with the buttonIP address, browser string, referring page URL, and (if logged in) account-linked friend data are transmitted to Meta upon page load for every consenting visitor
6Data controllerMeta entity structureMeta Platforms Ireland Limited (EU/EEA) or Meta Platforms, Inc. (UK and rest of world), only upon click-throughJoint Controller arrangement between you and Meta for the collection/transmission phaseJoint Controller arrangement between you and Meta for the collection/transmission phase; Meta remains sole controller for any subsequent profile-based processing
7Processing locationMeta data transfer practicesEU (Meta Platforms Ireland Limited) for EU/EEA visitors / US (Meta Platforms, Inc.); CLOUD Act appliesEU (Meta Platforms Ireland Limited) for EU/EEA visitors / US (Meta Platforms, Inc.); CLOUD Act appliesEU (Meta Platforms Ireland Limited) for EU/EEA visitors / US (Meta Platforms, Inc.); CLOUD Act applies

Configuration A β€” Low Risk

Use this configuration when you want to offer Facebook sharing functionality with the smallest possible data footprint. Instead of embedding the official Share Button plugin (which loads the Facebook SDK for every visitor), implement a plain hyperlink that opens Facebook's share dialogue (facebook.com/sharer/sharer.php?u=YOUR_URL) in a new tab. This is a documented alternative to the embedded plugin that uses the Facebook Share Dialog without requiring the JavaScript SDK to be loaded on your page. No fb-root div, no SDK script, and no iframe are present on your website, meaning no cookies are set and no data is transmitted to Meta unless and until the visitor actively clicks the link and is redirected to Facebook's own domain. At that point, the visitor is interacting directly with Facebook as an independent visit, governed by Facebook's own terms, and your role as joint controller does not arise because no collection or transmission occurs on your site. No consent gate is required for the link itself, though best practice is to label it clearly as an outbound link to Facebook.

Configuration B β€” Medium Risk

Use this configuration when you want to embed an interactive Share Button or Follow Button directly on your page. Consent must be obtained via the consent banner before the Facebook JavaScript SDK loads; until consent is given, the plugin should be replaced with a placeholder. Once consent is given and the SDK loads, the plugin is implemented via a fb-root div and the Facebook SDK script loaded from connect.facebook.net, with the button rendered inside an iframe. As established by the CJEU, you and Meta are joint controllers for the collection and transmission of personal data via the plugin, and you are responsible for informing visitors and obtaining their consent for this collection. Upon loading, Meta receives the IP address, browser string, and referring page URL of every consenting visitor β€” regardless of whether they actually click the button. The datr cookie is set, identifying the browser independent of the visitor's Facebook login state, for a duration of approximately two years. No friend facepile or other account-linked personalisation is shown. A joint controller arrangement (Meta's "Controller Addendum") governs the respective compliance responsibilities for the collection and transmission phase.

Configuration C β€” Higher Risk

Use this configuration when you embed the Page Plugin with friend facepile enabled and/or combine it with Embedded Posts or Embedded Videos on the same page. Consent must be obtained before the SDK loads, as in Configuration B. The Page Plugin lets you embed and promote a public Facebook Page on your website, allowing visitors to like and share the Page without leaving your site, and when friend facepile is enabled, it shows real people's profile images of friends who like the Page rather than just a number. This requires Meta to check whether the visitor is logged into Facebook and, if so, to access and display data about their social graph β€” constituting authentication-derived identification and profile-based personalisation. In addition to the datr cookie, the fr cookie (typically expiring after 90 days) is set, which Facebook uses to support ad measurement and to recognise users across sessions and across other sites carrying Facebook plugins or the Facebook Pixel. Running multiple plugin instances increases the frequency and volume of data transmitted to Meta on each page load. As with Configuration B, a joint controller arrangement applies for the collection/transmission phase; Meta remains the sole controller for any subsequent processing, such as building advertising profiles from the collected data.


Step 2 β€” Mapping in the Consenter Manager

Using the Facebook Social Plugin configurations defined in Step 1, apply the following mappings in the Consenter Manager to ensure the consent banner correctly reflects the data processing activities.

2.1 Configuration A β€” Low Risk

Consenter Manager SettingValue to Select
Tracking methodNo tracking (until click-through to facebook.com)
IdentifierNo identifier
Data categoriesNone (only applicable once the visitor clicks through to Facebook's own domain)
Legal role of data recipientIndividual Controller (applies only upon click-through)
Personalisation modelNo personalisation
Maximum storage durationNot applicable β€” no data collected on your site
Processing locationEU (Meta Platforms Ireland Limited) / US (Meta Platforms, Inc.); potential access via CLOUD Act

Note: Because no connection to Meta is established until the visitor actively clicks the link, this configuration does not require an entry in the consent banner for tracking purposes. However, it is good practice to disclose in your privacy policy that clicking the link will take the visitor to a third-party website operated by Meta.

2.2 Configuration B β€” Medium Risk

Consenter Manager SettingValue to Select
Tracking methodThird party tracking (cross-session, cross-website)
IdentifierDevice identifiers, IP address
Data categoriesBrowsing and interaction data, Device characteristics, Device identifiers, IP address
Legal role of data recipientJoint Controller
Personalisation modelNo personalisation
Maximum storage durationUp to 24 months (datr cookie)
Processing locationEU (Meta Platforms Ireland Limited) / US (Meta Platforms, Inc.); potential access via CLOUD Act

2.3 Configuration C β€” Higher Risk

Consenter Manager SettingValue to Select
Tracking methodThird party tracking (cross-session, cross-website, cross-device)
IdentifierDevice identifiers, IP address, Authentication-derived identifiers, Direct identifier
Data categoriesBrowsing and interaction data, Device characteristics, Device identifiers, IP address, Authentication-derived identifiers, Users' profiles, Direct identifier, Social media interaction data
Legal role of data recipientJoint Controller
Personalisation modelProfile based
Maximum storage durationUp to 24 months (datr cookie); up to 90 days (fr cookie); profile data retained per Meta's standard account retention while the visitor's Facebook account remains active
Processing locationEU (Meta Platforms Ireland Limited) / US (Meta Platforms, Inc.); potential access via CLOUD Act

Note: Meta requires website operators using its joint-controller plugins to enter into the standard Controller Addendum and to disclose the joint processing arrangement in their privacy policy. Meta Platforms Ireland Limited has previously been fined €1.2 billion by the Irish Data Protection Commission for unlawfully transferring EU/EEA user data to the US, underscoring that data transferred via these plugins β€” even when initially processed in the EU β€” may ultimately be processed in or accessed from the United States, which should be clearly disclosed to visitors.

Shape Consenter Together

Consenter is built on an open and participatory process that grows through community collaboration. Whether you share feedback, improve the documentation, or contribute to the Risk Configuration Guides or Technical Integration Guides, your expertise helps make Consenter more privacy-friendly, interoperable, and useful for everyoneβ€”including your own users and services: Get finally your benefits and control the risks when sharing personal data.

Last updated on

On this page