Basic Settings

The Basic settings page gives you one place to configure important settings, like your apps' name, contact email, and category, and find the app secret assigned to your app by Facebook. The settings listed on this page are needed for you to build an app on the Facebook Platform.

Screenshot of Settings > Basic in left-hand menu and Basic panel displayed.

General Settings

General settings contains unique identifiers assigned to your app and allows you to provide additional information to further define and describe your app. These identifiers allows us to identify your app when it makes API calls, and helps us determine which permissions and features your app has been granted by app users, and are used to generate access tokens.

App ID

When you create a Facebook app we generate and assign it a unique ID. This ID must be included when making any calls to our APIs. All of our SDKs provide a way for you to easily set this value in your codebase so that will automatically be included with any API calls.

App Secret

Your app secret is used in some of the Facebook Login flows to generate an App access token which can make API requests on behalf of any user of the app. It is extremely important that an App Secret be stored securely and not be included in any code that could be accessed by anyone other than a developer of the app.

We recommend that App access tokens only be used directly from your app's servers in order to provide the best security. For native apps, we suggest that the app communicates with your own server and the server then makes the API requests to Facebook using the App access token.

If your app secret is compromised, you can reset it in the App Dashboard.

Display Name

The display name is the user facing name of your app that will be displayed in the App Center. This field is required to switch your app to Live mode.

Display Name Guidelines

Follow these guidelines when choosing or modifying your app's display name, otherwise it will be rejected during App Review.

  • Do not use names that include Facebook or FB, or any names of Facebook products such as Oculus, WhatsApp, or Instagram.
  • Do not use "F", "Book", or "Face" in your name if it could be perceived as a reference to Facebook.
  • Do not use our brands in a way that implies partnership, sponsorship, or endorsement by us.
  • Do not combine any part of our brands with your name.
  • Do not use names or logos that imitate or could be confused with our brands
  • Do not present our brand assets in a way that make them the most distinctive or prominent feature of your app.

Namespace

The namespace URL links to your app's Canvas page. The Canvas page is used to tell user about your app.

App Domains

Domains and subdomains of your app for app installation and are used during Graph API request for verification.

Contact Email

The contact email is the email address where developer notifications will be sent. This field is required to switch your app to Live mode.

Privacy Policy URL

The Privacy Policy URL links to your app's privacy policy that applies to your app users.

Terms of Service URL

The Terms of Service URL links to the Terms of Service for your app that applies to your app users. This field is required to switch your app to Live mode.

User Data Deletion

The User Data Delection URL links to explicit instructions for your app users on how to delete their data from your app. This URL may be the relevant section in the application's Privacy Policy.

The data deletion URL is called when users remove your app by way of the Facebook's Apps and Website settings page, and then in the Removed section, click your app and request that their data be deleted.

Learn more about data deletion.

App Icon

The App Icon represents your app in the App Center. This field is required to switch your app to Live mode.

App Icon Guidelines

Follow these guidelines when uploading or replacing your app icon, otherwise it will be rejected during App Review.

  • Do not use or incorporate any of our logos, trademarks, icons, or any modified forms or variations of them. This includes logos, trademearks, and icons for any of our other products, such as Oculus, WhatsApp, or Instagram.
  • Do not include "Facebook" or "FB".

Category

Your app’s category helps users discover new apps based on their search. This field is required to switch your app to Live mode.

App Purpose

Your app's purpose is used during App Review to tell us how your app will access and use your data or data of others. This field is required to switch your app to Live mode.

Verification

The Verification settings are used to verify who you are. Either Business Verification or Individual Verification is required to access data that is not owned by you. While neither is required to switch your app to Live mode, you will not be able to access data you do not own until verification is complete.

Business Verification

Business Verification is a process that allows Facebook to verify your identity as a business entity. This is required if you will be requesting Advanced Access for your Business Type app, that is, if your app will be accessing data owned by other businesses.

Learn more about Business Verification.

Individual Verification

Individual verification is a process that allows us to verify your identity as an individual as opposed to a business, which we require if your app will be accessing sensitive data.

Learn more about Individual Verification.

Verification Status

After you have submitted for verification, your status will be Pending then Verified once Facebook has verified your Business or Individual information.

Data Protection Officer Contact Information

The General Data Protection Regulation (GDPR) requires certain companies that serve individuals in the European Union to designate and publish contact information for a Data Protection Officer (DPO) who can assist with matters related to the processing of personal information. This information will be made available in your apps and website settings so that your app users can contact your DPO if they have questions about how their data is processed and used.