Publishing an App

After completing development, verifying best practices, and checking approval requirements, you may submit your app for Marketplace approval in the Developer Portal. This article takes you step-by-step through the submission form and provides descriptions for each field.

Before you begin

Your listing on the Apps Marketplace plays a major role in your app’s success. A good listing accomplishes three goals:

  • Shows users how your platform or solution differs from competitive offerings
  • Includes keywords so prospective users can find your listing in searches
  • Sets up clear and accurate user expectations as to your solution’s features and functionality

Before you begin completing the app registration, we recommend prepping the following assets:

  • Company logos
  • Screenshots and video content
  • Case studies

We also recommend giving special attention to the following search indexed fields:

  • App name
  • App summary
  • App category

Provide a summary

To begin the app certification process, we’ll need some basic information about you.

DevTools 01

Field Description
Contact Name Email address created when applying for your Partner ID
Partner Name Name of your company​; attributed on the detail page
Partner Website URL to your homepage
Support Email Business mail where users can get help with the app
Support Website Used for Get Support button in Marketplace
Partner ID Required for submission; assigned to partners after approval
App Name Brand name given to app for titles and app content; should not include taglines or descriptors
App Logo Primary app logo; should be 350 x 130px with a white background and dark branding with no taglines
App Icon Shown on main app detail page and left nav in control panel once installed; should be 200 x 200px
Price App’s starting price; if offering free plan, choose Free; specify details in Other selection
App Summary App tagline used in the marketplace category and search results; 128 character max
Category Marketplace category for app; used as search attribute; BigCommerce may re-categorize prior to launch

Add technical information

Specify app type, multiple users support, callback URLs, and OAuth scopes; and, provide detailed testing instructions.

DevTools 02

Field Description
Multiple Users Optionally allow your app to be accessible to store users other than owner
App Type Type of app; single-Click recommended
Auth Callback URL Requested when install clicked
Load Callback URL Requested when user launches app
Uninstall Callback URL Requested when store owner clicks uninstall
OAuth Scopes OAuth scopes the app requires
Test Instructions Instructions needed to test the app thoroughly

Fill in details

Provide a helpful description with screenshots and a video to promote your app. We recommend bullet points followed by short paragraphs with headers. Aim for 200 words in total.

DevTools 03

Field Description
App Details Value proposition; avoid fluff or buzzwords; not be indexed for search; 200 words max
Videos Videos highlighting purpose and value of your app
Case Studies case studies demonstrating how merchants have benefited from using your app. 4 max
Features App’s major features; include title and description for each; title is search indexed; rich text accepted; 5 max
Legal Termals & Privacy App privacy policy and ToS links; legally required
International Optimization Countries app optimized for and countries app does not support
Help Guides Links to app’s user and installation guides; highly recommended
App Screenshot Screenshots of app UI inside BigCommerce
Alternate Logo Used if app featured in Marketplace carousel; should be 259 x 158px (or larger at ratio); dark background and light branding; no taglines

Review submission

Review the information added before submitting the app.

DevTools 04

Submit your app for approval

Ensure all information is complete; test the app before submitting for review.

DevTools 05

If you have any questions about your submission, email


Are all fields required?

For Marketplace approval, you’ll need to fill out all fields on your listing with applicable content and links. These will be reviewed as part of the Marketplace approval process. The Case Studies field and Videos field are optional.

Am I able to preview the changes to my listing before publishing them?

Yes! With the updated fields in the Developer Portal, we’re also adding the ability to preview how these changes will appear on the BigCommerce Marketplace. You will see the option to preview on a new step after Review when editing your listing.

Is there a draft status for these changes, or will saving make them live?

Any changes you save will take effect immediately, so make sure you’re ready to push them out to the Marketplace before saving.

I’ve logged in to the Developer Portal, but I don’t see my published listing. Where is it?

You may have logged in with the wrong account. Each listing can only be owned by one user, so it is likely assigned to another email address. If you’re unable to track down the correct owner account for your solution, please reach out to

I saved my changes, but my listing has not updated yet. What’s the problem?

The changes will be effective immediately in your control panel app card, but the updates can take up to 24 hours to appear on the Apps Marketplace. Feel free to use this as a grace period to make edits as needed.

Next steps

Review the Apps Marketplace listing guide (PDF).


Sample apps


Blog posts