Listing page requirements

Last updated:

In addition to complying with the Theme Provider Branding Guidelines, template providers must adhere to the following requirements set by HubSpot when submitting templates and their listing pages to the HubSpot Template Marketplace. These standards apply to all templates on the Marketplace.

HubSpot reserves the right to change the information on your template listing submission to comply with the following requirements. Read more about best practices for listing a theme or module on the HubSpot Template Marketplace

List a template on the HubSpot Template Marketplace

  • In your Template Marketplace provider account, navigate to Template Marketplace Listings.
  • In the upper right, click Create listing
  • Select either Create theme listing or Create module listing
  • Review the information on the Provider Information page, then click Next
  • Review your payment information on the Payment Information page, then click Next.
  • Select the theme or module you want to list, then click Save and continue.  You'll then be brought to the listing editor.

Listing Info

Provide the following information:

  • Listing name: the name that will appear on your template listing.
    • Use a unique and descriptive name for your template and avoid using the following:
      • The word "theme", "module", or "section" to identify the template type (e.g.“Example Theme” or “Easy Accordion Module”) as the templates are categorized by their type. 
      • Your company name (e.g.“Growth by HubSpot” or “Slider | HubSpot”).
      • Version numbers (e.g.“Growth - 1.21” or “Growth v2”) as the HubSpot Template Marketplace uses its own versioning system for published templates. 
      • The word "Hub" (e.g. "Hub Growth").
  • Price: select Free or Paid. If you’re listing a paid template, enter a price as well. Once published, you cannot change between Free and Paid plan types. 
  • Live example link: a link to a live version of your template so users can test it. Do not link to an image. 
  • Thumbnail image: the image that appears in search results and on the storefront card.
    • This image must showcase your theme or module as the primary focus of the image. At least 75% of the image's content should be your template.
    • Images must not contain any of the following:
      • Excessive marketing verbiage, slogans, text, or branding (e.g. "Over 100 features plus support!!!" or superimposing text/branding over the image). 
      • Imagery of individuals (real or fictitious) posing, pointing, o holding items (e.g. an image of a person holding a computer with your template on the screen).
      • Imagery that shows personal or private information. 
      • Badges and/or banners containing information related to reviews and installs of your template, or website performance grading. These types of data can fluctuate and have the potential to mislead others. If you’re a HubSpot Partner and would like to display your partner tier and/or badge, please ensure it’s the most current version.
    • Images will be removed at the HubSpot Ecosystem Team's discretion if they violate the guidelines above. 


Examples of good theme thumbnail images:


Examples of good module thumbnail images:


Theme/Module Details

Provide the following information:

  • Demo video (optional): the demo video should showcase your template in action and convey proper use cases.Videos must be in mp4 format, and it's recommended to use a 4:3 or 16:9 ratio for optimal viewing. While optional, the video is recommended as buyers find them valuable when evaluating a purchase.
  • Theme description/module overview:  a summary of your template's key selling points. Descriptions should include the following
    • A summary
    • Key selling points
    • How your template can help buyers achieve their goals
    • For theme descriptions,  you do not need to include a listing of the modules or templates included in the theme as these are already listed on the template listing page.
    • For individual modules, it must be noted in the description if the module requires the use of a 3rd party account. For example, if your module makes use of the Google Maps Platform, include the note “The use of this module requires a Google Cloud (Google Maps Platform) account.”
  • Features: feature titles are displayed in the Template Marketplace list view and are one of the first things your buyers see. You must add a minimum of two and up to five features for a template. Use the features section to highlight the following:
    • Key features of the template
    • Use cases and how it can solve your buyers' problems
    • You can also add marketing-based imagery to convey feature sets. 
  •  Client Examples (Themes only): examples (i.e. functional websites of your clients) are important for customers to see how other companies are using your template. It allows potential buyers to get an idea of how to use your template and also see how customizable it can be. It's strongly recommended to ensure that you have written permission from your clients to link to their websites. If requested, please make your client’s written permission available for verification.
  • Module Images (Modules only): up to 20 images of your module to demonstrate how it integrates into a template. Modules must contain, at minimum, the following screenshots:
    • How the module will appear on the page to front-end users.
    • Screenshots of both content and style settings.
  • The page-level editor settings of the module. If repeater content is used in the module, you must provide a screenshot of one instance of the repeating item settings.


  • Category and attributes:
    • For themes, your business types, pages types, and page features must be relevant to the theme you are submitting.
    • For modules, your template types and categories must be relevant to your module. 
  • Search tags: add up to 15 keywords for your top features and style attributes.
    • A set of default tags are assigned to your theme. If a particular tag isn't available, you can add a new tag.
    • Tags must be between 2–3 words long.
    • Use tags that accurately show the theme or module listed.
    • You may not use tags that contain the following:
      • Company names such as HubSpot or Example Company.
      • Subjective terms such as "top-rated," "best," or "number one".
      • Tags that describe the template type such as "theme," "module," or "email," as these are implied based on the template type being viewed.
      • Profanity or derogatory language.
    • If you have more than two business types for your theme, you can add the extra types as tags in your listing. 


  • Free support: select whether you offer free support to buyers of your template, and what languages you support.
  • Support channels: all support email addresses must be working email address. If you offer Live Chat, Facebook messenger or Phone support, ensure that these are in working order.
    • Avoid using hubspot@[companyname].com as your support email address.
  • Self-support support resources: the setup documentation URL must link to documentation on how to set up and use your template. It cannot be a link to your demo video, unless the demo video itself contains documetnation.
  • Terms of Service and Privacy Policy: all URLs entered must be linked to your website and refer to your company's terms and privacy. Do not use HubSpot's terms and privacy links. 


On the Review tab, validate your template's code. To preview how your template will look like on the Marketplace, click Preview listing

General imagery requirements

Images and screenshots will be removed at HubSpot’s discretion if they violate the guidelines above.

Make sure to use full-size images of your template to showcase its appearance and functions. The following image dimensions are strongly recommended for the best viewing experience of your template listing:

  • Storefront Card thumbnail image:
    • Size: Minimum 480px x 360px (4:3 ratio)
    • Formats: JPG, JPEG, PNG
  • Theme/Module images (minimum of two and up to 20 full-size images of your template):
    • Minimum width: 1160px
    • Formats: JPG, JPEG, PNG
  • Feature images:
    • Size: Minimum 480px × 360px (4:3 ratio)
    • Formats: JPG, JPEG, PNG
  • Client examples:
    • Size: Minimum 480px x 360px (4:3 ratio)
    • Formats: JPG, JPEG, PNG

Templates must not include images from the HubSpot-Shutterstock integration.

Other requirements

All verbiage, images, media, and default content used in the template must match what is advertised on the template listing page and demo site. For example, if your template listing is geared towards real estate with a working demo, the end user must receive that theme. If upon purchase the end user is delivered a theme centered around fitness instead, this would be considered a bait-and-switch, which is unacceptable. 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.