Using Page Tabs

Facebook Pages are a heavily used feature of Facebook. Major brands, celebrities, and organizations use Facebook Pages as their social home on the web. Besides standard tabs like "About", "Events" or "Photos" you can add custom Page tabs via the Facebook platform. These custom Page tabs load content from your webserver using an iframe.

This guide mainly covers how to add and manage Page Tabs through dialogs, however you can do this also with the Graph API /{page-id}/tabs edge.

Adding Tabs

In order to enable this feature, you need to specify a Page Tab Name and a Secure Page Tab URL (HTTPS address of your content, much like you provided a Canvas Page and Canvas URL previously) that is loaded when the user selects your Tab on a given Facebook Page. Note that SSL support for your page tab app has been mandatory since October 1, 2011.

To configure a Page tab, go to the App Dashboard and select Settings > Basic. Now click on the Add Platform button and choose Page Tab from the dialog. Now you can configure some settings for your new tab:

The Page Tab Edit Url is a third-party link provided by a page tab app developer or page tab admin to page admins. This is used to customizing the page tab app.

Adding an App to a Page

The Add Page Tab Dialog prompts a person to add an app to a Facebook Page that they admin. This does not require any extended permissions.

There is no response data from this dialog, however the developer of the Page Tab app will be notified via a callback URL that someone has added their app to a Facebook Page.

With JavaScript SDK

This dialog can be used with the JavaScript SDK, and by performing a full page redirect to a URL.

  method: 'pagetab',
  redirect_uri: 'YOUR_URL'
}, function(response){});

The above example assumes that the person has already logged in to your app.

With URL Redirects

You use the following parameters in the redirect:



Your app's unique identifier. Required.


The URL to redirect to after a person clicks a button on the dialog. Required when using URL redirection.


Determines how the dialog is rendered.

  • If you are using the URL redirect dialog implementation, then this will be a full page display, shown within This display type is called page.
  • If you are using the JavaScript SDK, this will default to a modal iframe type for people logged into your app or async when using within a game on, and a popup window for everyone else. You can also force the popup or page types when using the JavaScript SDK, if necessary.
  • This dialog is not available on mobile devices.

Page Tab Width

The amount of space available to your tab app is bounded by the outer context of Facebook. It may be configured to display with a width of 520 pixels (default) or 810 pixels.

Page Tab Position

You can update a Page tab's position at the Graph API edge {page-id}\tabs. You need a Page access token and manage_pages permission.

Make a POST request, passing the parameter tab=TAB_NAME&position=TAB_POS.

Integrating with Facebook APIs

When a user navigates to the Facebook Page, they will see your Page Tab added in the next available tab position. Broadly, a Page Tab is loaded in exactly the same way as a Canvas Page. When a user selects your Page Tab, their browser will send a HTTP POST request to your app's Secure Page Tab URL. This request will contain a Signed Request in the signed_request parameter with fields you can use to customise the content returned to the user.

In addition, your app will also receive a string parameter called app_data as part of signed_request if an app_data parameter was set in the original query string in the URL your tab is loaded on. It could look like this:**any_string_here**

You can use that to customize the content you render if you control the generation of the link.