Build your presence on Marketplace

Listing add-ons publicly in the Atlassian Marketplace requires three main components:

  • Vendor material that represents you or your organization
  • Add-on specific assets
  • Support documentation

As you'd expect, you can't violate Atlassian trademark and copyright guidelines or those of other parties.

Create a vendor profile

Your vendor profile establishes credibility when users are browsing your add-on(s), so be sure to put some thought and effort into your name and logo. We strongly recommend outsourcing your logo to a graphic designer. There are resources that can help you find one easily and cheaply, such as 99designs or Fiverr.

Vendor name

Displayed with your add-ons, homepage sidebars, and on your vendor page. Use your company name or, if an individual, your own name. Be mindful of trademark and copyright guidelines. Short names are preferred.

Length/Size: Up to 40 characters

Vendor description

Describe your what organization does/what problem(s) it intends to solve.

Length/Size: Up to 750 characters

Vendor logo

Upload a large, clear, front-facing image that fits into a square. Your logo should be relevant to your vendor name, as it will appear on your vendor page next to your name. Make sure it has a transparent background.

Length/Size: 144 x 144px PNG/JPG/GIF

Contact details

Add as much contact information as you can, especially a link to your own website, if you have one.

Length/Size: N/A

Support details

How can your users contact you if they need support? Even better is providing an external link to support documentation. If you sell paid-via-Atlassian add-ons, you must provide support contact details.

Length/Size: N/A

Create a listing for your add-on

The Marketplace requires branding materials to list your add-on on the site, whether your add-on is free or paid. In usability testing, customers express preferences for multiple small screenshots, shorter text elements, and easy-to-digest highlights. For this reason, we require three highlights for every add-on in the Marketplace. This also provides a uniform visual experience from add-on to add-on and lets Marketplace visitors quickly learn what three things your add-on can do for them.

If you're struggling to come up with three distinct highlights for your add-on, we suggest framing your add-on in different contexts. For example, how does your add-on make working in an Atlassian application easier? What are the broad goals people can meet using your add-on? Does it save time? Does it improve admin tasks? 

Conversely, if you are unsure how to trim your add-on benefits down to only three, consider a similar approach. Instead of listing all the things your add-on can do, list the most salient benefits. We suggest choosing three distinct high-level benefits. 

In the hero version of the listing, you have the option to include a video. We suggest including a video walkthrough of your add-on if possible.

3 Highlights

Hero

Add-on name

Use title casing (for example, Project Planner, not Project planner) to name your add-on in 40 characters or less. Using the Atlassian product name is acceptable (Add-on Name for Product Name), but not starting with the product name. For example, JIRA Plugin X would be rejected, but Plugin X for JIRA would be approved.

Ensure your add-on name does NOT include the following words and names: Atlassian, plugin, beta, BETA, Beta and add-on.

Length: 40 characters or less

Example: Project Planner for JIRA

Add-on tagline

Provide a short phrase that summarizes what your add-on can do.

Length: 130 characters or less

Example: Project planner makes project management a cinch. Plan and schedule tasks using our intuitive interface in JIRA.

Add-on summary (Legacy)

Provide a plain text add-on summary in 250 characters or less. Marketplace displays your add-on summary in search results.

Length: 250 characters or less

Example: Project planner makes project management a cinch. Plan and schedule tasks using our intuitive interface, and see real-time updates when a task runs long or short.

Description (Legacy)

Provide a description of your add-on in plain text except for bullets, line breaks, and hyperlinks.

Length: No limit, but we recommend 1000 characters or less.

Example: Project Planner helps you plan and track projects more efficiently. Get real-time calendar updates when an issue runs longer or shorter than expected, and capture snapshots of your project health to share with stakeholders and contributors.

Project Planner is used in over 90 countries to make project management easier and more efficient. You can feel secure in your timeline projections using Project Planner.

More details

List awards, testimonials, accolades, language support, or other details about your add-on. Marketplace displays this field in plain text except for hyperlinks, bullets, and line breaks.

Length: 1000 characters or less

Example: Project Planner helps you plan and track projects more efficiently. Get real-time calendar updates when an issue runs longer or shorter than expected, and capture snapshots of your project health to share with stakeholders and contributors.

Project Planner is used in over 90 countries to make project management easier and more efficient. You can feel secure in your timeline projections using Project Planner.

Video

Provide a YouTube link to a short video about your add-on. Users like short videos (30 seconds or less), and videos that show how your add-on is used. Marketplace displays your video as 800 x 600px.

Length/Size: No limit

Add-on logo
144 x 144px 

Upload a crisp logo at 144 x 144px. Use transparent or bounded, chiclet-style backgrounds. Marketplace automatically creates an add-on icon from your logo.

Note: You cannot use any Atlassian product logo as part of your add-on logo or contents. For more details see the Trademark Guidelines.  

Ensure your logo is unique. If you have add-ons that provide the same function across different Atlassian products, it's okay to use the same logo.

Size: 144 x 144px PNG/JPG

Template: Download template

Add-on banner
1120 x 548px  

Provide a banner at 1120 x 548px in PNG/JPG format. Include your add-on name, your vendor name, and brief text about your add-on's functionality. Users see this banner displayed in the UPM when they browse the Marketplace from their Atlassian host product.

Size: 1120 x 548px PNG/JPG for high-resolution images or 560 x 274px PNG/JPG for standard images

Template: Download high-resolution template | Download standard template

Highlight title (3)

Add a short action-oriented title for your highlight.

Length: 50 characters or less.

Example: Track time

Highlight summary (3)

Summarize your add-on's key features.

Length: 220 characters or less.

Example:  View issue and task progress relative to your deadlines and sprints

Highlight screenshot (3)

Illustrate your highlight with a screenshot. High-definition display screenshots encouraged.

Size: 1840 x 900px PNG/JPG or 920 x 450px PNG/JPG for standard images.

Template: Download high-resolution template | Download standard template

Highlight screenshot - cropped (3)

Provide a cropped version of your screenshot. This image is displayed prominently on the add-on details page.

Size: 580 x 330px PNG/JPG

Template: Download template

Highlight screenshot explanation (3)

Provide an explanation for your screenshot.

Length: 220 characters or less.

Example:  In this screenshot, you can see how to set deadlines for multiple issues at a time.

Additional highlight resources

  • Up to 5 additional screenshots per highlight, 1840 x 900px PNG/JPG or 920 x 450px PNG/JPG for standard images
  • Up to 5 additional screenshot explanations, up to 220 characters each

For a deeper dive, check out How to create an awesome Marketplace listing.

Describe your release

Each release of your add-on should contain a summary and can also include additional info, such as release notes and/or documentation. 

Item

Description

Release summary

Summarize your add-on release in 40 characters or less. Required for all add-ons.

Length: 40 characters or less

Example: Better compatibility for Google Chrome

Release notes

List new features and/or bug fixes included in your release.

Length: 1000 characters or less

Example:

  • Added customizable project health snapshots
  • Resolved display issues in Google Chrome

Documentation URL

Provide a URL where add-on users can find version-specific or general documentation for your add-on. Required for for paid-via-Atlassian add-ons; optional for others.

Version officially supported

Paid-via-Atlassian add-ons must be supported by the vendor; for all other public listings vendor support is optional. For supported add-ons, the add-on listing will show a link to the support info provided in the vendor profile.

Atlassian Answers enabled

Indicate if you want Marketplace to create a special tag for your add-on in Atlassian Answers. When enabled, add-on users can ask and receive answers from members of the Atlassian Answers community.

Issue tracker

Provide a URL where add-on users can file issues and bugs.

Was this page helpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport