> This page is for Developer. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.bigcommerce.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server. # Managing Apps in the Developer Portal Create, edit, and submit apps for approval using the [Developer Portal](https://build.bigcommerce.com/). In [Beginning App Development](/developer/docs/integrations/apps/guide), we briefly touched on how to create a draft app. In this article, we'll go over how to perform other common app management tasks. To get started, sign in or create an account in the [Developer Portal](https://build.bigcommerce.com/). > **Note** > > #### Store email address constraint > > Apps that aren't approved for distribution through the [App Marketplace](https://www.bigcommerce.com/apps/) can only be installed on stores owned by the same email address as the developer portal account's email address. ## Create an app profile Creating an app also creates an app API account. To learn more about app API accounts, see the [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#app-level-api-accounts). To create an app, do the following: > **Note** > > #### Information optional > > No app profile fields are mandatory unless you're preparing the app for BigCommerce [App Marketplace](https://www.bigcommerce.com/apps/) approval. To learn more about preparing an app for approval, see our [App Publishing Guide](/developer/docs/integrations/apps/guide/publishing-apps). 1. Sign in or create an account with the [Developer Portal](https://build.bigcommerce.com). 2. Click the **Create app** button on the right side of the landing page. ![Create an App](/_fern-img/036b16ad27620173b5eaeb860cff2d738265e3e26fa95dd41bf73d4fb62fb319.webp) 3. Give your app a name in the **Set up your app** dialog. This name is only visible to you. Once complete, click the **Generate Credentials** button. ![Name the app](/_fern-img/c5c91e4b70267d39fe9d1560bca52bf1a7dc96fa7e63fbf419b26a398f215324.webp) 4. The **app created** dialog appears, displaying your app’s Client ID and Client Secret. Click the **Finish** button to redirect the page to the app editor. ![App Editor](/_fern-img/0f970b3737bc01b9a94bbe2e7631c08ef1e0365c64fb07872886a16c0da2b674.webp) 5. Click the **Scopes** tab at the top. ![Scopes](/_fern-img/700121dc713b514759c60adfdbdbb350daff37e183a88dad887ec017e48ab178.webp) 6. Toggle the necessary OAuth scopes for your app. ![Assign OAuth scopes](/_fern-img/219ccf69d68baff20d4251a73a061a77297efe7a9f474b4ab83dc1e8efdbc6b1.webp) 7. Click the **Save changes** button on the registration dialog's lower right corner. 8. A new dialog opens, asking if you want to add new OAuth scopes. Click **Confirm new scopes**. ![Confirm OAuth changes](/_fern-img/d0d0286a28e71d6dabd4a32d4f6dc2ec0e74ac23ca81364a4225071485011126.webp) You can view the client ID and client secret any time; see the following section on [viewing credentials](#view-credentials). ## View credentials 1. To view an app API account's credentials, navigate to the Dev Portal's [Apps overview](https://build.bigcommerce.com/apps) and click the **View credentials** icon to the right of the relevant app's listing. ![Menu - view credentials](/_fern-img/d3d178e46c8a0381febfd2b71c211249ace149550e6e137febbdf243389dd086.webp) 2. A dialog box opens to reveal your API account credentials. To learn more about using an app API account to generate store-specific access tokens, see [Implementing the OAuth Flow](/developer/docs/integrations/apps/guide/auth). ## Edit an app profile 1. To edit an app, navigate to the Dev Portal's [Apps overview](https://build.bigcommerce.com/apps) and click the name of the app you want to edit. ![Menu - edit app](/_fern-img/d2231b1b2715a4812f08503350b8fc211bc5726e72ae0c7d9af9ea6bebea5591.webp) 2. The app editor opens. ![App Editor](/_fern-img/0f970b3737bc01b9a94bbe2e7631c08ef1e0365c64fb07872886a16c0da2b674.webp) > **Note** > > #### Marketplace delay > > Edits can take up to 24 hours to appear in the [App Marketplace](https://www.bigcommerce.com/apps/), but changes are immediately effective and visible in your existing users' store control panels. ### Edit technical details 1. Once you [enter the app editor](#edit-an-app-profile), click the **App information** tab at the top to edit enabled features and callback URLs. ![Technical Details](/_fern-img/8e6727d589945d37184bd83dd383df6ba909f04eca22654091b8f091e4d19fb2.webp) 2. To edit OAuth scopes, click the **Scopes** tab at the top. ![Assign OAuth scopes](/_fern-img/219ccf69d68baff20d4251a73a061a77297efe7a9f474b4ab83dc1e8efdbc6b1.webp) 3. To save your change, click the **Save changes** button on the editor's lower right corner. 4. A new dialog opens, asking if you want to add new OAuth scopes. Click **Confirm new Scopes**. ![Confirm OAuth changes](/_fern-img/d0d0286a28e71d6dabd4a32d4f6dc2ec0e74ac23ca81364a4225071485011126.webp) 5. After saving, edits are effective immediately for all app users. ### Indicate multi-storefront support If your app supports stores that sell through multiple storefronts or sales channels, add that information to the app's profile. 1. Once you [enter the app editor](#edit-an-app-profile), click the **Listing information** tab at the top. ![Listing information](/_fern-img/4dc967a3d38fb68e2feaaee54bda83790c66b0e58e7b1c76849e1f440275e183.webp) 2. Select either **Single Storefront** or **Multi Storefront**. This doesn't grant or deny your app access to any APIs; it helps us test and label your app appropriately. ![MSF Toggle](/_fern-img/7a8473ef6efe21d8cb6afb2aa9c498de4ac63bd820efbeec024eeabee6230970.webp) 3. To save your change, click the **Save changes** button on the edit dialog's lower right corner. To read about designing or modifying your app to support multi-storefront, see [Multi-Storefront App Compatibility and Optimization](/developer/docs/integrations/apps/optimizing-multi-storefront-apps) ## Submit an app for approval 1. Submit apps for [App Marketplace](https://www.bigcommerce.com/apps/) approval by navigating to the Dev Portal's [Apps overview](https://build.bigcommerce.com/apps), then finding the app you want approved and clicking the **Publish app…** option from the action menu to the right of its listing. ![Menu - publish](/_fern-img/5ab08f06dd35dc44829f263924269ab714bff6afbb0c10354e0dab6f5c9ab5db.webp) 2. The **Confirm listing information** page opens; verify the information provided, and click the **Submit app for review** button in the bottom right corner. To learn more about completing app registration fields and submitting apps for approval, consult our [App Publishing Guide](/developer/docs/integrations/apps/guide/publishing-apps). ## Deleting apps Deleting an app also deletes its API account. This is a destructive action; you can't recover the app or its API account. Do not delete an app without serious consideration, particularly if it is in production. It is likely to have far-reaching negative impacts on your users' stores. To learn about mitigating the risks of deleting an app and its API account, see the [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#delete-apps-carefully). 1. To delete an app, navigate to the Dev Portal's [Apps overview](https://build.bigcommerce.com/apps) and click the **Delete app** option from the action menu to the right of its listing. ![Menu - delete app](/_fern-img/9322af29f62b4b99eb22d2eb4ad7f153018f44d24e26ec46a1a8c6ef795fb500.webp) 2. The **delete app dialog** opens to verify whether you truly want to delete the app. Click **Delete**. ![Delete App Dialog](/_fern-img/102b477cc802710526efc116de81c547192fcedada902eda65ef70ea1835b703.webp) ## Next steps * [Implement the OAuth flow](/developer/docs/integrations/apps/guide/auth) * [Handle app callbacks](/developer/docs/integrations/apps/guide/handling-callbacks) ## Resources ### Related articles * [Introduction to Building Apps](/developer/docs/integrations/getting-started) * [Beginning App Development](/developer/docs/integrations/apps/guide) * [Implementing App OAuth](/developer/docs/integrations/apps/guide/auth) * [App Approval Requirements](/developer/docs/integrations/apps/guide/approval-requirements) * [Publishing an App](/developer/docs/integrations/apps/guide/publishing-apps) * [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts) ### Other resources * [Developer Portal](https://build.bigcommerce.com/) (build.bigcommerce.com) * [Partner Portal](https://partners.bigcommerce.com/English/) (partners.bigcommerce.com) * [Technology Partner Program](https://partners.bigcommerce.com/English/register_email.aspx) (partners.bigcommerce.com) * [BigCommerce App Marketplace](https://www.bigcommerce.com/apps/) (bigcommerce.com)