App Dashboard

This document describes the App Dashboard interface and its settings. If you have just created a new app, you do not need to read all of this documentation and configure dashboard settings now; you can start building and testing right away and return to these documents to learn about relevant dashboard settings as needed.

Screenshot of the App Dashboard.

The App Dashboard allows you to configure settings that may be required by the products, APIs, and SDKs that your app will be using. It also provides tools to aid with app development, such as API usage meters, the ability to create test users and test pages, and the ability to assign roles to other people who may be helping you with development. The dashboard is also used to begin the App Review, Business Verification, and Individual Verification processes, if required.

To access the App Dashboard, go to the Apps panel and click on the name of the app you'd like to configure. This will load the app in the dashboard and you can then adjust its settings.

Apps Panel

The Apps panel serves as the App Dashboard's entry point. It displays basic information about each of your apps: their IDs, your role on each of them, and the number of unread developer notifications they have received. It also allows you to remove yourself from apps that you have been invited to by other developers, remove your own apps, archive your own apps, and begin the Data Use Checkup process, if required.

You can access the Apps panel at developers.facebook.com/apps or by clicking the My Apps link in the header that appears on all developers.facebook.com sub-pages:

Toolbar

The toolbar displays basic app attributes and allows you to switch among your apps.

App Selection Dropdown

Allows you to switch among your apps, create new apps, and create test apps.

Screenshot of App Selection Dropdown menu in the top toolbar.

App ID

App IDs are generated upon app creation. They are unique to each app and cannot be changed. App IDs are typically not needed unless you are programmatically adjusting your app's settings, or querying endpoints that require your app ID (there are only a handful of these).

App Mode Toggle

This toggle displays your app's current app mode status and allows you to switch between modes.

Screenshot of App Mode Toggle in the top toolbar.

All newly created apps start out in Development mode and should not be switched to Live mode until you have completed app development and are ready to release your app.

If you chose Business as your app type, you will not see a mode indicator because Business apps rely on access levels instead of modes.

App Type Indicator

This displays your app type. App types determine which products, permissions, and features are available to your app. If you chose Something Else when you created your app, you will not see this indicator.

Screenshot of App Type Indicator in the top toolbar.

Dashboard

The Dashboard panel is where you can find API usage meters as well as important notifications about required actions or upcoming changes that may impact your app.

Screenshot of Dashboard in left-hand menu and Dashboard panel displayed.

Information Card

Occasionally we will release new products or announce upcoming changes that may affect your app and display them here (you'll also receive a corresponding developer notification, unless you have disabled notifications).

Required Actions

Important messages about your app will be displayed here. These typically have to do with actions related to maintaining data access. You'll also receive a developer notification about these requirements.

Application Rate Limit

Displays your app's Graph API application rate usage. Learn more about Application rate limits.

User Rate Limit

Displays the number of your app users who have reached their Graph API user rate limit. Learn more about User rate limits.

API Stats

Displays basic statistics about your app's Graph API requests.

Marketing API Stats

Displays basic statistics about your app's Marketing API requests.

Page Rate Limit

Displays your app's Graph API Page rate usage. Learn more about Page rate limits.

Facebook Login Activity

Displays basic statistics about your app's Facebook Login activity.

Products

See Products.

Settings

The Settings panel is split into two separate panels: Basic and Advanced.

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

The Basic panel allows you to provide more granular information about your app, such as its category, platform, and icon. It also contains settings commonly needed to complete App Review, such as URLs to your privacy policy and terms of service.

Learn more about Basic settings.

The Advanced panel allows you to configure uncommon settings, such as security settings, age- and geo-targeting restrictions, and allows you to upgrade your app to newer versions of the the Graph API and Marketing API.

Learn more about Advanced settings.

Roles

The Roles panel can be used to send app role invitations to other people who may be helping you develop your app. This panel can also be used by Administrators to remove a person from a role.

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

App roles control who has access to your app's settings, and who can use your app (grant it permission to access their data) while it's in Development mode.

Learn more about app roles.

Alerts

The Alerts panel is where you can access developer notifications that we may have sent you, such as App Review submission status updates and alerts about upcoming API changes.

Screenshot of Alerts > Inbox in the left-hand menu and Alerts > Inbox panel displayed.

You can control which developer notifications you want to receive by using the Developer Settings panel.

App Review

The App Review panel allows you to create and submit App Review submissions.

Screenshot of App Review > Permissions and Features in left-hand menu and App Review > Permissions and Features panel displayed.

App Review is part of the release process — if your app will be used by people who do not have a role on your app, you will have to submit your app for review.

Learn more about the App Review process.

Products

Depending on what functionality your app needs, you may need to add a product to your app. Products span a wide range — they can be standalone software, SDKs, frameworks, plugins, or simply collections of APIs.

Screenshot of Products in left-hand menu and Products panel displayed.

Adding a product to your app enables relevant functionality and API access. It also adds a new product-specific panel to the dashboard, and in most cases, provides an interface for you to configure additional product-specific settings. For example, Facebook Login allows you to control oAuth settings and requires you to add a redirection URL. You can supply this information using the Facebook Login panel after you add the Facebook Login product to your app.

The developer documentation for the products listed on developers.facebook.com/products will indicate whether or not you need to add a corresponding product to your app using the App Dashboard.

Product Use Certification

Some products require you to certify that you will use them in compliance with our Plaftorm Terms and Developer Polices.

Screenshot of Product Use Certification modal for the oEmbed product.

You can complete initial certification by checking the checkbox in the Confirm Acceptance modal when adding these products to your app. You will also be required to annually recertify as part of the Data Use Checkup process.

Activity Log

The Activity Log is a historical record of changes made to your app through the App Dashboard. This panel will not appear until there has been activity on your app.