Last updatedOct 5, 2018

Building your presence on Marketplace

Listing apps publicly in the Atlassian Marketplace requires three main components:

  1. Vendor material that represents you or your organization
  2. App-specific assets
  3. Support documentation

Before creating material for items 1 and 2, make sure you're familiar with our brand guidelines for Marketplace vendors. As you'd expect, you can't violate Atlassian's trademarks or those of other parties.

Create a vendor profile

Your vendor profile establishes credibility when users are browsing your app(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 profile

AssetDimensionsDescription

Vendor name

Up to 40 characters

Displayed with your apps, 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.

Vendor description

Up to 750 characters

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

Vendor logo

144 x 144px PNG/JPG/GIF

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.

Contact details

N/A

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

Support details

N/A

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 apps, you must provide support contact details.

Create a listing for your app

The Marketplace requires branding materials to list your app on the site, whether your app 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 app in the Marketplace. This also provides a uniform visual experience from app to app and lets Marketplace visitors quickly learn what three things your app can do for them.

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

Conversely, if you are unsure how to trim your app benefits down to only three, consider a similar approach. Instead of listing all the things your app 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 walk through of your app if possible.

Three Highlights

details and highlights

Hero

details hero

AssetDimensionsDescription

App name

40 characters or less

Example: Project Planner for Jira

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

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

App tagline

130 characters or less

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

Provide a short phrase that summarizes what your app can do.

App summary (Legacy)

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.

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

Description (Legacy)

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.

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

More details

 

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.

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

Video

No limit

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

App logo

144 x 144px PNG/JPG

Template: Download template

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

You cannot use any Atlassian product logo as part of your app logo or contents. For more details see our brand guidelines for Marketplace vendors.

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

App banner

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

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

Highlight title (3)

50 characters or less.

Example: Track time

Add a short action-oriented title for your highlight.

Highlight summary (3)

220 characters or less.

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

Summarize your app's key features.

Highlight screenshot (3)

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

Template: Download high-resolution template | Download standard template

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

Highlight screenshot - cropped (3)

580 x 330px PNG/JPG

Template: Download template

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

Highlight screenshot explanation (3)

220 characters or less.

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

Provide an explanation for your screenshot.

Additional highlight resources

1840 x 900px PNG/JPG or 920 x 450px PNG/JPG for standard images (screenshots)

Up to 220 characters each (explanations)

  • Up to 5 additional screenshots per highlight
  • Up to 5 additional screenshot explanations

Describe your release

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

AssetDimensionsDescription

Release summary

40 characters or less

Example: Better compatibility for Google Chrome

Summarize your app release in 40 characters or less. Required for all apps.

Release notes

1000 characters or less

Example:

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

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

Documentation URL

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

Version officially supported

Paid via Atlassian apps must be supported by the vendor; for all other public listings vendor support is optional. For supported apps, the app 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 app in Atlassian Answers. When enabled, app users can ask and receive answers from members of the Atlassian Answers community.

Issue tracker

Provide a URL where app users can file issues and bugs.