Skip to main content

After you’ve created an app in your developer account that meets the App Marketplace listing requirements, you can submit a listing to add it to the HubSpot App Marketplace. The HubSpot Ecosystem Quality team will review your submission and follow up via email if the app has been approved or rejected.

In this article:

  • In your app developer account, navigate to Marketplace > App Listings.
  • In the upper right, click Create listing. If this button is grayed out, listings have already been created for all your existing apps.
  • Select the app you want to create a listing for and click Next. Apps that are already listed on the App Marketplace will not appear here.
  • On the next screen, click the Select the languages your app is available in dropdown menu and select the languages your app software is offered in. The App Marketplace is available in 14 languages: German, English, Spanish, French, Italian, Japanese, Dutch, Portuguese, Chinese, Finnish, Danish, Norwegian, Polish, and Swedish.
  • Click the Select the primary listing language for [app name] dropdown menu and select the default language users will see when browsing the App Marketplace.
  • Click Next.

The app listing wizard has five tabs of information to fill out.

On the Listing info tab:

  • In the App information section, add your Public app name, Company name, Tagline, and Install Button URL.

  • In the App icon section, upload an 800px by 800px icon for your app. This will appear in the App Marketplace and connected users’ accounts. When creating your icon:

    • Do: use a JPG, JPEG, or PNG file, fill the entire space (800px by 800px) - your image should touch at least two edges, and use a high-resolution, unpixellated image.
    • Do not: include text in your icon, use a wordmark, or leave extra whitespace around your icon.

dev-doc-logo

  • In the Categorize your app section, you can select up to two categories for your app. Learn more about the different categories available.
  • You can also review and set a URL path and add any search terms that can be used to find your app in the App Marketplace.

On the App details tab:

  • In the Demo video section, upload a video to show how your app works. Refer to the How to Make a Great App Demo Video page for best practices and examples of how to create a demo video.
  • In the Screenshots section, add images and alt text showing how your app works. You can add up to eight images.
  • In the App Overview section, enter an overview for your app. Your overview should include information on what your app does, the key business problems your app solves, and why users should install your app.
  • Click Add shared data. In the Shared data section, let users know how data will flow between your app and HubSpot.
    • In the right panel, select which app object syncs with which HubSpot object, and the direction of the sync. In the App Overview section, give a brief description of how your app can help users carry out their goals.
    • To add another object sync, click Add another object.

shared-data-app-listing

  • Click the HubSpot features your app works with dropdown menu and select the checkboxes next to the HubSpot features. You can add up to 10 HubSpot tools and features.
  • Click the Other tools your software integrates with dropdown menu and select the checkboxes next to any external tools or apps that your app integrated with. You can select up to 6 other tools or apps.
  • Click the Languages your app is available in dropdown menu select all languages available for your app. You can only create additional app marketplace listings in these languages.

On the Pricing tab:

  • Click the currency dropdown menu and select the checkboxes next to the currencies you want to list the app in. You can select from over 100 currencies.

  • You can also set up pricing plans for your app by adding the pricing model, plan name, tagline, pricing detail, and features list.

    • Depending on the pricing model selected, you may need to add more information, such as the frequency of payment, one-time fees, or monthly prices. Hover over the information icon to learn more about each pricing model.

      DD - App Pricing

    • To add another pricing plans, click Add another plan. You can add up to 5 pricing plans.

  • In the Link to your software’s pricing plan section, enter the URL where users can find more information on your pricing plans.

  • In the Agency pricing plans section, enter the URL where users can learn more about pricing for partner or consulting services.

On the App features tab, add features and guide customers on how to use them. There is no limit on the number of app features that can be created for your app.

  • In the top right, click Add a feature.

  • On the Feature details page, configure your app features:

    • Feature name: enter your feature name. This should describe your what your feature does.
    • Scopes: select all scope groups a customer's account will need to have this feature. Scope groups are used to determine whether the customer's HubSpot account is compatible with the app features.
    • Description: enter a detailed description for your feature, and how it can solve a customer's business problems.
    • Image: add an image for your feature. After adding your image, click to toggle the On your app's marketplace listing or As a feature discovery card switches on to configure where your images should display.
  • If you've chosen select to display the feature as a feature discovery card:

    • Select an option for your primary button:
      • Link to a feature: select which HubSpot feature the button should link to.
      • Create custom: enter Button text and the Button URL.
      • No primary button: no button will be displayed on your feature discovery card.
    • Select a how-to guide to onboard your customers:
      • Create a guide from scratch: enter a title, description, and image or video.
      • External link to guide: enter a Guide URL.
      • Video only guide: upload a video.
    • To add another guide, click Add another section.

On the Support info tab:

  • In the Contact info section, add a support contact method for users who have questions while using your app. It is required add a support email and languages that customer support is offered in. You can also include links to your company website, live chat, Facebook page, and a phone number.
  • In the Support resources section, include links to your app’s setup documentation.
  • In the Terms of Service and Privacy Policy section, add links to your privacy documentation.

On the Testing info tab:

  • In the App review instructions field, enter steps for HubSpot's developers to test the app as part of the review process. Learn how to providing testing details and credentials for your app.
  • In the App Partner Program points of contact section, add details for members of your team to receive listing, technical and program information about your app listing.
    • You must include at least an App Partner Program main point of contact and a Developer to contact. You must include the person's role, first name, last name, email, and country where they are based in.
    • To add another person as a point of contact, at the bottom, click Add another point of contact.

On the Review info tab:

In the App review section, a list of all listing errors will appear:

  • To review details for all listing errors, at the top, click Expand all.
  • To hide the details for all listing errors, at the top, click Collapse all.
  • To resolve an error, click the error name. This will direct you to the relevant tab and section to resolve the error.

  • If the Validate & submit button is grayed out, check that you’ve filled out all the required fields and have Super admin permissions.
    • If you’ve missed any required fields, you will see a number in the tab heading indicating the number of missed fields. Click each tab and enter the missing information, then return to the Review info tab.
    • At the bottom, click Run validation.

You will need to set a primary language on your existing app listing and have your primary listing already published in the HubSpot Marketplace in order to create listings in other languages.

  • In your HubSpot app developer account, click Marketplace > App Listings.

  • If you already have an app listed in the Marketplace, you’ll see a yellow banner above the listed app asking you to set your primary listing language. Click Set it now. You will need to set the primary listing language for the app listing before you're able to create new language listings.

  • In the dialog box, click the Select the languages your app is available in dropdown menu and select the languages your app software is available in.

  • Click the Select the primary listing language for [app name] dropdown menu and select the default language users will see when browsing the App Marketplace.

  • Click Save.

Once you have set a primary language, you will be able to add a new localized listing:

  • Hover over the app listing and click More > Create listing in another language.

  • If you'd like to auto translate your listing to other languages, click to toggle the Auto translate switch on.

    • If you've selected this option, any translated listings will be automatically and immediately published to the marketplace. The auto translated listings will bypass admin review.
    • Once the listings are translated, any edits made in the primary listing will not automatically update in the translated listings. To update an auto translated listing:
      • Delete the existing translated listing and then create translated listing again in the same languages. When creating a new listing, changes from the primary listing will be pulled in.
      • You can also manually update the translated listing. However, manual changes will go through the review process and has to be approved by HubSpot admins before being published.
  • Click the Language for this listing dropdown menu and select the language you want to create this listing in.

    • When a user has set the language in their account, then they will automatically see the listing in that same language. For example, if you've create a listing in Spanish, and a user has set Spanish as their account's default language, the listing will appear to the user in Spanish.
    • If the Auto translate option has been turned on, the languages selected will be auto translated and published as new listings.
  • Click Create. If you're manually creating a listing, follow the steps to create and submit a listing in the selected language.

Once an app listing is live on the app marketplace, to edit the listing:

  • In your developer account, navigate to Marketplace > App Listings.
  • Hover over the listing you’d like to edit and click More. Then, select Edit.
  • After making your changes, in the top right, click Validate & submit.
  • In your developer account, navigate to Marketplace > App Listings.
  • Hover over the listing you want to unpublish and click More. Then, select Unpublish live listing.
  • In the dialog box, enter the reason for unpublishing the app, the click Submit unpublish request.

Unpublish requests will be processed by the HubSpot Marketplace team within 10 business days of submission.