Skip to end of metadata
Go to start of metadata

Listing add-ons publicly in the Atlassian Marketplace requires two branding components. We require vendor material that represents you or your organization, and add-on specific assets. As you'd expect, your branding can't violate Atlassian trademark and copyright guidelines or those of other parties.

Add-on branding guidelines

We've redesigned the add-on details page so Marketplace users can more easily learn basic benefits of your add-on. In this new design, you'll provide a tagline, concise highlights, and screenshots. We've modified the assets required for publicly listing your add-on accordingly.

Add-on highlights

Item

Required

Description

Add-on name

UPDATED

(tick)

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 omits 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

NEW

 

(tick)


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)

(tick)

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)

(tick)

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

UPDATED

(tick)

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

(info)

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

UPDATED

(tick)

 

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.

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

Example:

Photoshop template: Download template

Add-on banner

UPDATED

 

(tick)  


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

Photoshop templates: Download high-resolution templateDownload standard-resolution template

Highlight title (3)

NEW

(tick)

Add a short action-oriented title for your highlight.

Length: 50 characters or less.

Example: Track time

Highlight summary (3)

NEW

(tick)

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)

NEW

(tick)

 

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. 

Photoshop template: Download high-resolution templateDownload standard template

Highlight screenshot - cropped (3)

NEW

(tick)

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

Size: 580 x 330px PNG/JPG

Photoshop template: Download template

Highlight screenshot explanation (3)

NEW

(info)

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

NEW

(info)
  • 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.
Icon
  • Images from high-resolution or Retina displays are encouraged
  • Animated GIFs are not permitted.
  • You're unable to submit your add-on for approval without images exactly matching size requirements.

Support & documentation guidelines

Publicly listed add-ons require documentation resources, even if your add-on is free. Paid-via-Atlassian add-ons require vendor support. 

Item

Required

Description

Documentation URL

(tick)

Provide a URL where add-on users can find version-specific or general documentation for your add-on.

Format: URL

Version officially supported

(tick) for paid-via-Atlassian, (info) for others

Paid-via-Atlassian add-ons require vendor support. All other public listings can choose "No."

Format: Radio buttons with options for yes and no.

Atlassian Answers enabled

(info)

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.

Format: Radio buttons with options for yes and now.

Issue collector

(info)

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

Format: URL

Release summary

(tick)

Summarize your add-on release in 40 characters or less.

Length: 40 characters or less

Example: Better compatibility for Google Chrome

New in this release

(tick) Unless information provided in "Fixed" field

Describe new add-on enhancements introduced in your release.

Length: 500 characters or less

Example:

  • Customizable project health snapshots
  • Project health snapshot exports in Excel and Google Spreadsheets

Fixed in this release

(tick) Unless information provided in "New" field

List bug fixes and specific tickets resolved in your add-on release.

Length: 500 characters or less

Example:

  • Display issues in Google Chrome resolved

Vendor branding guidelines

Item

Required

Description

Vendor name

(tick)

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: No longer than 40 characters.

Vendor logo

(info)

Upload a large, clear, front-facing image. Your logo should be relevant to your vendor name. This will appear on your vendor page.

Length/Size: 72x72px PNG/JPG/GIF

Vendor icon

(info)

Upload a smaller version of your vendor logo. This appears in the sidebar and top-ranked lists. If your logo does not scale down well, create an additional thumbnail image. In the future, your logo may be scaled to be your vendor icon.

Length/Size: 16x16px PNG/JPG/GIF

  • No labels