Graph API Version

Initialization

The method FB.init() is used to initialize and setup the SDK. If you have followed our SDK quickstart guide, you won't need to re-use this method, but you may want to customize the parameters used.

All other SDK methods must be called after this one, because they won't exist until you do.

FB.init(params)

Parameters

Name Type Description

params

object

A collection of initialization parameters that control the setup of the SDK. Click for more info.

appId

string

Your application ID. If you don't have one find it in the App dashboard or go there to create a new app. Defaults to null.

version

string

Determines which versions of the Graph API and any API dialogs or plugins are invoked when using the .api() and .ui() functions. Valid values are determined by currently available versions, such as 'v2.0'. This is a required parameter.

cookie

bool

Determines whether a cookie is created for the session or not. If enabled, it can be accessed by server-side code. Defaults to false.

localStorage

bool

Determines whether a long-lived access token for the session can be saved in localStorage. This enables maintaining a user's logged in status when 3rd party cookies are blocked from being sent to Facebook domains. Defaults to true.

status

bool

Determines whether the current login status of the user is freshly retrieved on every page load. If this is disabled, that status will have to be manually retrieved using .getLoginStatus(). Defaults to false.

xfbml

bool

Determines whether XFBML tags used by social plugins are parsed, and therefore whether the plugins are rendered or not. Defaults to false.

frictionlessRequests

bool

Frictionless Requests are available to games on Facebook.com or on mobile web using the JavaScript SDK. This parameter determines whether they are enabled. Defaults to false.

hideFlashCallback

function

This specifies a function that is called whenever it is necessary to hide Adobe Flash objects on a page. This is used when .api() requests are made, as Flash objects will always have a higher z-index than any other DOM element. See our Custom Flash Hide Callback for more details on what to put in this function. Defaults to null.

Examples

Example: Standard initialization code:

FB.init({
  appId      : '{your-app-id}',
  status     : true,
  xfbml      : true,
  version    : 'v2.7' // or v2.6, v2.5, v2.4, v2.3
});