It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Why are highlights and images required for authenticators in marketplace?

Gary Weaver Jan 06, 2014

I have an authenticator in marketplace which does not offer any UI in Confluence so it needs no screenshot or image, and really doesn't need three highlights, but marketplace requires three highlights with pictures, it seems. Why is this enforced, and is there a way around this?

For example:

2 answers

1 accepted

2 votes
Answer accepted
Dave Meyer Atlassian Team Jan 07, 2014

We require three highlights and three images to ensure a consistent browsing experience on the Atlassian Marketplace for all customers. There are close to 2,000 add-ons in the Marketplace, and it's Atlassian's responsibility to ensure that the experience across multiple add-ons is cohesive.

In our extensive usability testing preceding the Marketplace redesign, we found that customers struggled to quickly get a sense of what an add-on does when confronted with a wall of text and no visual cues. Time and time again, customers told us that the first thing they do when visiting a page is "look at the screenshots." This might not be applicable to every add-on, but it's applicable to a significant enough proportion that we're comfortable making it a requirement to ensure consistency.

With regard to the three brief highlight descriptions, our general perspective is that if something is worth building, there are at least three things you can say about it. Perhaps what might seem obvious to you might not be obvious to someone else, but if it's worth building, it's likely worth the time to explain to someone else why it might be valuable to them. We introduced the three highlight structure in order to encourage everyone to succinctly describe the most important features, components, or capabilities of an add-on, rather than overwhelming page visitors with a long list of features or failing to provide a description of the add-on's value entirely--both of these provide a relatively poor user experience.

Likewise, with the three highlight screenshots, we encourage developers to relate the screenshots to the highlight text, but realize that this might not be a perfect fit in every case. Nevertheless, there's no requirement that your images must be screenshots. You can use diagrams, graphics, logos, or all manner of other visual clues to support your listing.

I hope this helps you guys understand why we've made the design choices you see on the Marketplace. Don't hesitate to contact me directly with additional questions.



Product Marketing, Atlassian Marketplace

Gary Weaver Jan 07, 2014

Dave, Thanks, that's a good explanation, but I feel if the three images can be purely aesthetic, then marketplace could provide a variety and/or default aesthetic images to choose from that work with the colors and look of marketplace. Otherwise, creative commons pics of kittens will have to do for now. In addition, marketplace does not enforce the consistent width of the pic, so my kitten pics have a black rectangle next to them. I think it might look better to make the uploader crop the pic within the browser, which is the typical thing you see in just about every other website that allows uploads for the purpose of filling defined space (e.g. Gravitar, Facebook, G+, etc.). I'd be happy to suggest this via a Jira ticket, but "marketplace" doesn't come up in, so am mentioning here if it helps. Thanks again for your help!

0 votes
Andy Brook (DEV) Jan 07, 2014

You could use exact shaped white boxes, it has been known...

Suggest an answer

Log in or Sign up to answer
This widget could not be displayed.
This widget could not be displayed.
Community showcase
Posted in Marketplace Apps & Integrations

Demo Den Ep. 4: Continuous Integration with CircleCI & Jira Software

Get ready! Demo Den Episode 4 is coming your way on Tuesday, May 28, 2018 with a Continuous Integration and Delivery special demo. CircleCI Director of Solutions Engineering, Eddie Webb will show us ...

67 views 0 2
Join discussion

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you