Facebook Developers
DocumentationSupportBlogAppsLog In
  • Getting Started
  • Core Concepts
  • Advanced Topics
    • Dialogs
    • FQL
    • Internationalization
    • Ads API
    • Credits
    • Chat API
    • Legacy REST API
    • Legacy FBML
    • Legacy FBJS
    • Legacy Javascript SDK
  • SDK Reference
  • Tools
  • Tools
    • fb:board
    • fb:bookmark
    • fb:chat-invite
    • fb:comments
    • fb:default
    • fb:else
    • fb:feed
    • fb:friend-selector
    • fb:google-analytics
    • fb:if
    • fb:if-multiple-actors
    • fb:multi-friend-input
    • fb:quantcast
    • fb:random
    • fb:random-option
    • fb:switch
    • fb:typeahead-input
    • fb:typeahead-option
    • fb:user-agent
  • User/Groups
    • fb:eventlink
    • fb:grouplink
    • fb:if-can-see
    • fb:if-can-see-photo
    • fb:if-is-app-user
    • fb:if-is-friends-with-viewer
    • fb:if-is-group-member
    • fb:if-is-user
    • fb:if-is-verified
    • fb:name
    • fb:profile-pic
    • fb:pronoun
    • fb:user
    • fb:user-status
  • Notifications and Requests
    • fb:application-name
    • fb:multi-friend-selector
    • fb:multi-friend-selector_(condensed)
    • fb:req-choice
    • fb:request-form
    • fb:request-form-submit
  • Platform Internationalization
    • fb:date
    • fb:fbml-attribute
    • fb:intl
    • fb:intl-token
    • fb:tag
    • fb:tag-attribute
    • fb:tag-body
    • fb:window-title
  • Deprecated
    • fb:if-is-own-profile
    • fb:if-user-has-added-app
    • fb:networklink
    • fb:notif-email
    • fb:notif-page
    • fb:notif-subject
    • fb:profile-action
    • fb:rock-the-vote
    • fb:userlink
    • fb:visible-to-added-app-users
    • fb:visible-to-user
  • Status Messages
    • fb:error
    • fb:explanation
    • fb:message
    • fb:success
  • Page Navigation
    • fb:create-button
    • fb:dashboard
    • fb:header
    • fb:header-title
    • fb:help
    • fb:mediaheader
    • fb:owner-action
    • fb:tab-item
    • fb:tabs
  • Wall
    • fb:wall
    • fb:wallpost
    • fb:wallpost-action
  • Visibility on Profile
    • fb:18-plus
    • fb:21-plus
    • fb:restricted-to
    • fb:visible-to-app-users
    • fb:visible-to-connection
    • fb:visible-to-friends
    • fb:visible-to-owner
  • Profile-specific
    • fb:action
    • fb:add-section-button
    • fb:if-section-not-added
    • fb:narrow
    • fb:publisher-link
    • fb:subtitle
    • fb:user-item
    • fb:user-table
    • fb:wide
  • Misc
    • fb:add-profile-tab
    • fb:fbml
    • fb:fbmlversion
    • fb:js-string
    • fb:page-admin-edit-header
    • fb:redirect
    • fb:ref
    • fb:serverFbml
    • fb:time
    • fb:title
  • Editor Display
    • fb:editor
    • fb:editor-button
    • fb:editor-buttonset
    • fb:editor-cancel
    • fb:editor-custom
    • fb:editor-date
    • fb:editor-divider
    • fb:editor-month
    • fb:editor-text
    • fb:editor-textarea
    • fb:editor-time
  • Embedded Media
    • fb:flv
    • fb:iframe
    • fb:mp3
    • fb:photo
    • fb:silverlight
    • fb:swf
  • Dialog
    • fb:dialog
    • fb:dialog-button
    • fb:dialog-content
    • fb:dialog-title
  • Additional Permissions
    • fb:prompt-permission
  • Social Plugins
    • fb:comments
    • fb:live-stream
  • Message Attachments
    • fb:attachment-preview
  • Forms
    • fb:captcha
    • fb:submit
  • Reference
    • JavaScript SDK

fb:prompt-permission

Advanced Topics › Legacy FBML › fb:prompt-permission
FBML has been deprecated. Starting June 1, 2012 FBML apps will no longer work as all FBML endpoints will be removed. If you are building a new application on Facebook.com, please implement your application using HTML, JavaScript and CSS. You can use our JavaScript SDK and Social Plugins to embedded many of the same social features available in FBML.

Renders the content of the tag as a link that, when clicked, initiates a dialog requesting the specified extended permissions from the user. You can prompt the user for a series of permissions.

If the user has already granted a permission, a dialog for that permission does not appear. If the user has not already authorized the application before clicking the link, he or she is prompted to authorize it before being prompted for the permission.

You can prompt a user to approve the following extended permissions for your application:

  • Allowing email to be sent to the user
  • Reading from a user's stream
  • Publishing posts to a user's stream
  • Granting offline access (what used to be known as an infinite session) for your application
  • Updating user status
  • Uploading and tagging photos
  • Creating and modifying events
  • Setting a user's RSVP status for an event
  • Sending SMS to the user
  • Uploading videos to user profiles
  • Writing, editing, and deleting notes on user profiles
  • Posting links to user profiles

Parameters

NameTypeDescription
permsstring

A comma-separated string representing the extended permissions being requested. Specify any of the following permissions: email, read_stream, publish_stream, offline_access, status_update, photo_upload, create_event, rsvp_event, sms, video_upload, create_note, share_item.

next_fbjsstring

The FBJS that will be called if the user grants the requested permission.

Examples

Whether you are formatting this tag as FBML or XFBML, it requires a closing tag.

<fb:prompt-permission perms="email">Would you like to receive email from our application?</fb:prompt-permission>
<fb:prompt-permission perms="read_stream,publish_stream">Would you like our application to read from and post to your News Feed?</fb:prompt-permission>
Updated about 4 months ago
Facebook © 2012 · English (US)
AboutCareersPlatform PoliciesPrivacy Policy