The document provides guidance on designing add-ons for Atlassian products. It recommends conducting user testing early to check if designs are usable and aligning with Atlassian design guidelines. User feedback should be gathered through various methods like surveys and testing to ensure add-ons are meeting user needs and providing meaningful actions within the product context. Secondary actions should be moved out to keep the interface simple.

1. Designing add-ons for
Atlassian products
The Do’s & Don’ts
LUCY DENTON | UX DESIGNER | ATLASSIAN

2. A user interface is like a
joke. If you have to explain
it, it’s not that good.
MARTIN LEBLANC
ICONFINDER.COM

3. Provide meaningful
actions
Ecosystem design principles
Be HarmoniousKeep it simple

4. Consider the user’s workflow
Give them what they need to achieve their goals.
Remain contextually relevant
Consider the heirarchy and concepts within the
products.
Don’t add random features
Allow users to focus on their work.

5. our v1 tables to the v2 tables, which in our case would also need to create an addon. That is the only clean solution as
we don't want to replace the token for the installations as then all the existing integrations will break.
Monday April 15, 2015
Alana Lee 3:39 PM
Awesome job everyone! Lets keep an eye on social media and other feeback avenues. Maybe we can get some
insights on how we are doing.
Alana Lee 3:39 PM
Emma Lane 3:39 PM
Can’t agree more ^
Well done team, super proud of the achievement and for hitting this major milestone.
Alana Lee 3:39 PM
Sounds like a great idea.
Lets organise a team lunch!…
Harvey Goldsworthy 3:39 PM
Hey team, the new website has been launched today! Good job everyone who helped out with the designs.
Confluence 3:39 PM
Design team lunch
confluence.team.com
Space: Design Created by: Mia Wong
Emma Lane shared page: Design team lunch
Design
Confluence
Design team
Great design is making something memorable and meaningful
ROOMS
PEOPLE
Design
Project Managers
Soccer Team
Development
3
7Quality Assurance
Coffee Club
Finance
Create a room
Emma Lane
Mia Smith
Harvey Goldsworthy
Lucy Clinton
Jose Bond
Aundray Lee
Michael Triscott
Atlassian
New chat Search history
My work
Mary Justin - Created 14 June 2016
Mia Wong - Updated 11 June 2016
Alana Lee - Created 10 June 2016
Will Henry - Updated 7 June 2016
Emma Lane - Updated 1 June 2016
What we can learn about UX…
New illustrations
Design team lunch
Workshop learnings: Two d…
Updated website banner des…
Shona McLennon - Created 15 June 2016
Typography update
Open in Confluence
Share to room

6. SpottyFly
Search Spotify
PLAYLISTS
YOUR MUSIC
Your Daily Mix
Radio
Songs
Albums
Artists
Stations
Local Files
Hottest 100
Created by: Lucy Denton
Beyond the Valley
Created by: Dugald Morrow
Mental Metal
Created by: Royce Wong
Discover weekly
Browse
our v1 tables to the v2 tables, which in our case would also need to create an addon. That is the only clean solution as
we don't want to replace the token for the installations as then all the existing integrations will break.
Monday April 15, 2015
Alana Lee 3:39 PM
Awesome job everyone! Lets keep an eye on social media and other feeback avenues. Maybe we can get some
insights on how we are doing.
Alana Lee 3:39 PM
Emma Lane 3:39 PM
Can’t agree more ^
Well done team, super proud of the achievement and for hitting this major milestone.
Alana Lee 3:39 PM
Sounds like a great idea.
Lets organise a team lunch!…
Harvey Goldsworthy 3:39 PM
Hey team, the new website has been launched today! Good job everyone who helped out with the designs.
Emma Lane 3:39 PM
Wow! we’re getting some great feedback. I’ll organise lunch but first check out our first bug MM-123
Lucky we included the feedback function or else we would of missed out on gems like these.
MM-123: Autocomplete in search does not work and yields unexpected results
Type: Status:Priority: Major TO DO Assignee: Bruce LeeBug
Design team
Great design is making something memorable and meaningful
ROOMS
PEOPLE
Design
Project Managers
Soccer Team
Development
3
7Quality Assurance
Coffee Club
Finance
Create a room
Emma Lane
Mia Smith
Harvey Goldsworthy
Lucy Clinton
Jose Bond
Aundray Lee
Michael Triscott
Atlassian
New chat Search history
What do you mean?
Justin Bieber Purpose
SpottyFly
Chill afternoon
100,000 Followers
Beyond the Valley mix
230 Followers
Get Popped!
800,976 Followers
Discover weekly
42,000 Followers
Aussie Alternative
134,998 Followers
our v1 tables to the v2 tables, which in our case would also need to create an addon. That is the only clean solution as
we don't want to replace the token for the installations as then all the existing integrations will break.
Monday April 15, 2015
Alana Lee 3:39 PM
Awesome job everyone! Lets keep an eye on social media and other feeback avenues. Maybe we can get some
insights on how we are doing.
Alana Lee 3:39 PM
Emma Lane 3:39 PM
Can’t agree more ^
Well done team, super proud of the achievement and for hitting this major milestone.
Alana Lee 3:39 PM
Sounds like a great idea.
Lets organise a team lunch!…
Harvey Goldsworthy 3:39 PM
Hey team, the new website has been launched today! Good job everyone who helped out with the designs.
Emma Lane 3:39 PM
Wow! we’re getting some great feedback. I’ll organise lunch but first check out our first bug MM-123
Lucky we included the feedback function or else we would of missed out on gems like these.
Nice one @growth
MM-123: Autocomplete in search does not work and yields unexpected results
Type: Status:Priority: Major TO DO Assignee: Bruce LeeBug
Design team
Great design is making something memorable and meaningful
ROOMS
PEOPLE
Design
Project Managers
Soccer Team
Development
3
7Quality Assurance
Coffee Club
Finance
Create a room
Brent Norris
Chris Kent
Emma Lane
William Packer
Mia Smith
Harvey Goldsworthy
Lucy Clinton
Jose Bond
Aundray Lee
Michael Triscott
Atlassian
Overview Charts Genres & Moods N
Back

7. Enable users to close the loop
People respond to information and make
decisions. Make it easy for them.
Remain contextually relevant
Provide meaningful actions within the context of
the parent product.
Move secondary actions out
Throwback - keep it simple.

8. Confluence
Files
Links
People
95
Monday April 15, 2015
Alana Lee 3:39 PM
Awesome job everyone! Lets keep an eye on social media and other feeback avenues. Maybe we can get some
insights on how we are doing.
Alana Aware 3:39 PM
Emma Lane 3:39 PM
Can’t agree more ^
Well done team, super proud of the achievement and for hitting this major milestone.
Alana Lee 3:39 PM
Sounds like a great idea.
Lets organise a team lunch!…
Harvey Goldsworthy 3:39 PM
Hey team, the new website has been launched today! Good job everyone who helped out with the designs.
Incident management 3:39 PM
#477: Everything is on fire.
Design team
Great design is making something memorable and meaningful
ROOMS
PEOPLE
Design
Project Managers
Soccer Team
Development
3
7Quality Assurance
Coffee Club
Finance
Create a room
Emma Lane
Mia Smith
Harvey Goldsworthy
Lucy Clinton
Jose Bond
Aundray Lee
Michael Triscott
Atlassian
New chat Search history
3 Triggered
Back
3 Triggered
#477: Everything is on fire.
All servers in the main server
building have spontaneously
caught on fire. This is the full
description section. It can be max.
200 characters long.
Severity: Sev-2
Escalates in 29m
ServiceNow 3:13pm, 19 July 2016
SEV-2
Confluence
Files
Links
People
Monday April 15, 2015
Alana Lee 3:39 PM
Awesome job everyone! Lets keep an eye on social media and other feeback avenues. Maybe we can get some
insights on how we are doing.
Alana Aware 3:39 PM
Emma Lane 3:39 PM
Can’t agree more ^
Well done team, super proud of the achievement and for hitting this major milestone.
Alana Lee 3:39 PM
Sounds like a great idea.
Lets organise a team lunch!…
Harvey Goldsworthy 3:39 PM
Hey team, the new website has been launched today! Good job everyone who helped out with the designs.
Incident management 3:39 PM
#477: Everything is on fire.
Service: ServiceNow Severity:
Design team
Great design is making something memorable and meaningful
ROOMS
PEOPLE
Design
Project Managers
Soccer Team
Development
3
7Quality Assurance
Coffee Club
Finance
Create a room
Emma Lane
William Packer
Mia Smith
Harvey Goldsworthy
Lucy Clinton
Jose Bond
Aundray Lee
Michael Triscott
Atlassian
New chat Search history
3 Triggered
Back
3 Triggered
#477: Everything is on fire.
All servers in the main server
building have spontaneously
caught on fire. This is the full
description section. It can be max.
200 characters long.
Severity: Sev-2
Escalates in 29m
ServiceNow 3:13pm, 19 July 2016
SEV-2
SEV-2 Acknowledge

9. SpottyFly
Chill afternoon
100,000 Followers
Beyond the Valley mix
230 Followers
Get Popped!
800,976 Followers
Discover weekly
42,000 Followers
Aussie Alternative
134,998 Followers
our v1 tables to the v2 tables, which in our case would also need to create an addon. That is the only clean solution as
we don't want to replace the token for the installations as then all the existing integrations will break.
Monday April 15, 2015
Alana Lee 3:39 PM
Awesome job everyone! Lets keep an eye on social media and other feeback avenues. Maybe we can get some
insights on how we are doing.
Alana Lee 3:39 PM
Emma Lane 3:39 PM
Can’t agree more ^
Well done team, super proud of the achievement and for hitting this major milestone.
Alana Lee 3:39 PM
Sounds like a great idea.
Lets organise a team lunch!…
Harvey Goldsworthy 3:39 PM
Hey team, the new website has been launched today! Good job everyone who helped out with the designs.
Emma Lane 3:39 PM
Wow! we’re getting some great feedback. I’ll organise lunch but first check out our first bug MM-123
Lucky we included the feedback function or else we would of missed out on gems like these.
MM-123: Autocomplete in search does not work and yields unexpected results
Type: Status:Priority: Major TO DO Assignee: Bruce LeeBug
Design team
Great design is making something memorable and meaningful
ROOMS
PEOPLE
Design
Project Managers
Soccer Team
Development
3
7Quality Assurance
Coffee Club
Finance
Create a room
Emma Lane
Mia Smith
Harvey Goldsworthy
Lucy Clinton
Jose Bond
Aundray Lee
Michael Triscott
Atlassian
New chat Search history
Overview Charts Genres & Moods N
BackGoal: 45 Current: 43
All feedback
MonkeySurvey
“URGGGGGH really? Wish you
could make it responsive…”
23 August 2015
“I really wish they would make it
possible to customise the sche…”
23 August 2015
“I love how easy it is to use. The
latest software update has ma…”
23 August 2015
“Really, really, super impressed
with this product. I think that th...”
23 August 2015
“product is super great, feels
super snappy now that they ha…”
23 August 2015
“I wish the UX was a bit more…”
23 August 2015
“It’s pretty good but I wish ther…”
23 August 2015

10. Keep it recognisable
Use the Atlassian Design Guidelines to follow
Atlassian’s design language.
Check with users
Usability test your designs early.
Follow similar patterns in the product
When in doubt, be consistent.

12. Screen Recordings
Start recording Select a recording
No recordings attached

14. Talk to users

15. 10%
10%
10%
20%
50%
WHY DON’T VENDORS TALK TO USERS?
Didn’t consider it.
Some vendors have never thought to
actually talk to their users as a way
of improving their product.
Don’t know how.
Some vendors want to get feedback
from their users, but don’t know how
to get started.
Non-priority.
A large group of vendors see user
testing as a non-priority. They have to
work on building a solution first.
Don’t have time.
The majority of vendors feel they
don’t have time or resources to pull
off user testing.
Not worth it.
Some vendors think user research is
not worth the effort, time, and cost.

16. Agile user testing
• Get the right participants.
• Record your sessions.
• Help participants feel
comfortable.
• Ask the right questions.
• Ask them to think aloud.
• Don’t correct them if they’re
wrong.
• Don’t jump to conclusions based
on what 2 people said.

17. “It was probably the best
thing we did. It helped so so
so so so so so very much.
ELEVATOR FOR JIRA, REFLECTING ON USER TESTING DAY

18. Share ideas

19. Sparring
• Give context of the problem.
• Walkthrough the proposed
solution.
• Participants write feedback points
on sticky notes.
• Discuss, debate, challenge.
go.atlassian.com/playbook/plays/sparring

20. Tools

21. atlassian.design
go.atlassian.com/ak
go.atlassian.com/aui
go.atlassian.com/playbook

22. Thank you!
LUCY DENTON | DESIGNER | ATLASSIAN | @LUCINDA_DENTON