How do I create or edit a HubSpot App Marketplace listing?

With a developer account in HubSpot, you can create an application to integrate with HubSpot.  Once you’ve created your app, submit a listing to add your app to the HubSpot App Marketplace. HubSpot will review your listing submission and follow up via email.  Please note, you must be a Super Admin to successfully update and submit the app listing for review.  If the submit for review button is grayed out, please check that you have filled out all required fields and have the adequate permissions. 

Answers to common questions:

  1. How do I create an app listing?
  2. How do I submit my app listing for review? 
  3. How do I edit my app listing once it is live on the HubSpot App Marketplace?

 

 

How do I create an app listing?

  • In the main navigation menu of your developer account, navigate to App MarketplaceListings.

Screen Shot 2019-11-20 at 11.32.43 AM

  • Click Create listing. If this button is grayed out, listings have already been created for all of your existing apps.
  • Select the app you want to create a listing for. Apps that have already been added to the App Marketplace will not appear here. 
  • Click Next.

app-listing-flow-select-app

  • In the App information section, enter the basic information about your app:
    • Public name: enter the name that will appear on your listing.
    • Tagline: enter a brief description of what your app does for users.
    • Connect button URL: enter the URL on your website where users can integrate your app with HubSpot.
  • In the App Icon section, click Upload to add an icon that will appear in the App Marketplace and in a user's account once installed.
TIP: Best Practices for App Icon's
app-icon-do-donts

 

  • Do use JPG, JPEG, or PNG files. 
  • Do fill the entire space, touching at least 2 edges.
  • Do use a clear image (not pixilated).   
  • Don’t include text in your app icon
  • Don't use a wordmark as the app name will appear next to your icon.
  • Don’t leave extra white space around your icon
TIP: Leverage the Image Cropper Tool to Ensure Your Icon is 800px
imagecropper

 


  • In the Categorize your app section, click the Category dropdown menu to select the category that best fits your app. Then click the dropdown menu below to select up to five features that apply to your app. The available features here are based on the category you selected above.
  • Under Search terms, you can add up to six search terms to make sure your app appears in search results for specific queries. Type a search term and press Enter/Return or click Create option “[search term]” in the dropdown menu. Separate multiple search terms with a comma.
app-listing-flow-categorize
  • Click the App Details tab.
  • To include a demo video in your app listing, click Upload under Demo video. Your video must be an MP4 file and should not include any sensitive information. Your demo should:
    • Provide users with a brief overview of your product/integration.
    • Walk through key customer use cases.
    • State the task to be performed and by whom.
    • Indicate data what data is syncing to or from HubSpot.
    • Show HubSpot UI elements  (CRM Extensions, Timeline Events, Workflow Extensions) and how customers are expected to use them
    • Be five minutes or less.  
  • In the Images section, click Upload and add at least one screenshot image to your listing. In the Image caption text box, enter a description for your screenshot. You can add up to seven additional screenshots by clicking Add screenshot.
app-listing-demo-video-and-images
  • In the Key Benefits text box, highlight a few benefits that users will get from your app. Format your text using the rich text toolbar at the bottom to draw attention to your copy. 
app-listing-key-benefits
  • In the How it works with HubSpot section, add information and screenshots for at least two specific features in your app:
    • In the Headline field, enter a brief description of the feature.
    • Under Screenshot, click Upload to add a screenshot of the feature. You can leverage the image cropper tool to resize your image.
    • In the Paragraph box, add additional information about the feature which will appear under the feature headline. 
  • To add more than two feature headlines and screenshots, click Add another.
app-listing-how-it-works-with-hubspot
  • Click the HubSpot plans your app works with dropdown menu and select the HubSpot plans a user must have to use your app.
  • Click the HubSpot features your app works with dropdown menu and select up to ten HubSpot tools that your app syncs with.
app-listing-flow-hubspot-plans-and-features
  • In the Shared Data section, click Add shared data.
  • In the right panel, add information about the different types of data that will sync to and from HubSpot when your app is connected:
    • Click the HubSpot data dropdown and select the type of HubSpot data that will sync to or from objects in your app.
    • Click the Direction dropdown and select the direction this data will be syncing:
      • Sync to HubSpot: data from your app will create or change data in HubSpot.
      • Sync from HubSpot: data from HubSpot will create or change data in your app.
      • Two-way sync: data will sync back and forth between HubSpot and your app.
    • In the Your app field, enter the tool or object in your app that information will sync to or from.
    • To add additional items, click Add another.
    • To share additional information with users about how data is shared, enter it in the More info about shared data box.
    • Click Save.
app-listing-shared-data
  • If your app integrates with any other software, type the software name in the Other tools your software integrates with dropdown menu and press Enter/Return or click Create option “[search term]” in the dropdown menu. You can separate multiple entries with a comma.
  • Click the Pricing tab. Here you can add up to five pricing plans to let HubSpot users know how much your application costs.
  • Select a Plan type:
    • Free: users can connect to your app for free. You can still add additional charges for tiered usage of specific features.
    • Recurring: set up a monthly or yearly recurring subscription for your app. Select a frequency, then enter the monthly or yearly rate. If you select Monthly for your frequency, you have the option to add a discounted yearly rate for users who want to be billed once for the whole year.
    • One-time fee: users will be billed the fee entered when they connect to your app.
  • If you will be charging fees for additional services or features, enter them in the Additional charges field.
  • If you want to allow users to trial your app before paying, enter the number of days for your free trial period in the Free trial field.
  • In the Plan name field, enter a name to help users identify this pricing plan.
  • In the Tagline field, enter a brief description of the plan.
  • In the Features list field, let users know what features are included in this plan.
  • If you want to add additional pricing plans, click Add another plan. You can include up to five pricing plans. 
app-listing-pricing-plan
  • If you have a more detailed pricing page for your app, enter the URL in the Link to your software’s pricing plans field.
  • If you offer any agency partner or consulting services, enter the URL linking users to more information in the Agency pricing plans field.
  • Click the Support info tab. Here you can provide users with self-service resources and contact information if they need help using your app.
  • Enter an email address in the Support email field. You can also provide a phone number and links to your company website, live chat, and/or Facebook page.
  • Click the Support languages dropdown menu and select any languages that you provide support in.
app-listing-support-contact-info
  • In the Resources section, enter URLs for your setup documentation, terms of service, and privacy policy. You can also add additional URLs to share your support website, community form, etc.
  • Click the Review info tab. In the App review instructions text box, enter instruction for HubSpot’s team to test your application.
  • Submit your listing for review, or click Save to save your progress and return to it later.

How do I submit my app listing for review?

  1. Click Save then Submit for Review. The HubSpot team will then review and provide feedback if necessary before ultimately approving your listing.
    • To successfully submit for review:
      • You must have Super Admin permissions. 
      • All required fields need to be complete. If there are numbers next to the tabs in the app listing flow, this indicates required fields are missing.
      • Screen Shot 2019-11-20 at 11.59.16 AM-1

How do I edit my app listing once it is live on the HubSpot App Marketplace?

  1. From your developer portal, select App Marketplace in the nav and select Listings.
  2. Find the listing you'd like to edit and hover between Name and Install. Select More and then Edit.
Screen Shot 2019-11-20 at 11.26.05 AM
      3. Make changes to your app listing, click Save then Submit for Review. The team will then review and ultimately approve changes.