Principles for inclusive language
Use words that reflect our diverse world
Inclusive language isnāt about following a list of good and bad words. Itās about taking an approach to your writing that avoids assumptions, stereotypes, and treats people with respect.
Our products are for all kinds of people. The words we use should help them have a great experience. Consider how your language is helping or harming people.
Make content easy to understand
Be inclusive by using plain language. Remove jargon, metaphors, and idioms. Simple wording is proven to help people complete their tasks faster and with higher success rates. It also ensures that you arenāt excluding people by using words that are specific to your context.
Learn from your audience
Rely on the expertise of people who belong to the groups youāre writing about. You can do this by reading resources put out by advocacy groups, or consulting with people from diverse communities. Never assume people from a diverse community want to educate or give feedback ā always ask for permission first.
How to describe people
Be clear
When you need to describe a group of people, use clear language that aligns with how people describe themselves.
When youāre not sure, always use person-first language. This language centers the person, rather than their difference. For example, āpeople with disabilitiesā, rather than ādisabled peopleā In some circumstances people prefer to use identity-first language to represent themselves, such as in the Deaf community.
You can reduce inaccurate assumptions or stereotypes by improving the way you describe peopleās differences. For example:
Good | Better | Reason |
---|---|---|
Alternative text helps people with visual disabilities interact with the user interface. | Alternative text helps people who use assistive technology interact with the user interface. | Not all people who use assistive technology, like screen readers have visual disabilities. Using this definition is more inclusive, and more accurate. |
This project was done in consultation with people of Indigenous backgrounds. | This project was done in consultation with First Nations Australians. | Use specific terms when referring to racial and ethnic groups. Vague terms don't acknowledge the different experiences of racial and ethnic communities. |
Donāt change words used to describe people
Donāt modify phrases to make differences sound positive. Words like ādifferently abledā or āhandi-capableā are patronizing, and donāt fit with the full diversity of human experiences.
Avoiding describing peopleās differences can reinforce the prejudices of society. Describing race, ethnicity, disability, age, class, gender, and sexuality isnāt a negative thing, unless these descriptions are being used in discriminatory ways. For example, only use the phrase āpeople of colorā when you donāt have enough information to be more specific.
Avoiding microaggressions
Microaggressions are actions that arenāt intentionally aggressive, but contribute towards an environment that excludes people towards people who belong to marginalized communities. This makes people feel excluded, fatigued, and unseen.
In writing, microaggressions are words that are associated with stereotypes, or phrases that have a negative origin, like ālong time no seeā ā a phrase historically used to make fun of people who spoke limited English, which has now slipped into casual use.
These words may seem inoffensive to some people. Remember that our goal is to do more than just avoid causing offence. We want to create products that include all people.
Avoid metaphors and idioms
Metaphors and idioms are non-literal phrases people use in regular speech. Metaphors are when people compare something to something else (such as āthey were like a fish out of waterā), while idioms are phrases where the meaning isnāt conveyed by any of the words (such as ābetween a rock and a hard placeā). Idioms are only understood from cultural familiarity with the phrase, which makes them unhelpful if youāre writing for a global audience.
Some metaphors and idioms invoke histories of violence, patriarchy, or colonization. Other metaphors and idioms can confuse people outside of the group, country, or culture the phrase originates from. This creates an environment that includes some people more than others.
When youāre writing content for a wide audience, be literal. Donāt rely on harmful or confusing phrases.
Example | Alternative | Reason |
---|---|---|
blacklist/whitelist | blocklist/allowlist | Associating āblackā with negative and āwhiteā with positive experiences perpetuates racial inequity. |
killing it | doing great work | Violent words are unnecessary, and can cause negative feelings. |
Automation in Jira makes issue creation a piece of cake. | Automation helps teams create issues faster. | Some people wonāt have heard the phrase āpiece of cakeā used this way before, especially if English isnāt their first language. This creates an unnecessary barrier to comprehension that you can avoid by being accurate and literal. |
Word use, appropriation, and reclamation
The context and identity of the person using a word or phrase can change whether a word or phrase is helpful or harmful. Sometimes words are used for their original purpose, sometimes they are appropriated, and sometimes words are reclaimed.
Appropriation is when words are used outside of their original context in ways that are hurtful or minimizing to a group of people.
Appropriation | Proper use | Reason |
---|---|---|
Letās have a powwow about the new logo. | Iām taking leave to attend a powwow. | Powwows are important cultural gatherings, and using this as a throwaway word to describe a meeting is offensive. |
Iām so OCD about deleting my emails. | My experiences getting diagnosed with OCD. | Avoid using medical and disability related terms as metaphors. It reinforces negative stereotypes. |
Reclamation is when a group starts using language that people previously used to harm them, with the intention to make it a positive word or phrase. For example, the word āqueerā was previously used as a homophobic term, but now many people describe themselves with the word āqueerā. Donāt use these words if you donāt belong to the group the word originates from.
Donāt make assumptions about abilities
Donāt use phrasing that makes assumptions about how people experience your product. For example, by making claims about how easy your experience is.
Example | Alternative | Reason |
---|---|---|
Itās easy to set up your project. | Set up your new project in a few steps. | Itās more precise about why the workflow is easy, without excluding people based on their abilities. |
Words that are misinterpreted as microaggressions
Designers avoid some words related to disabilities because theyāre trying to be inclusive. These words aren't microaggressions because words that relate to disabilities arenāt negative words. You only need to avoid using them in a negative context.
You can use them in your product experiences if they help make things clear.
Phrasing | Reason |
---|---|
Words related to vision, like: "View all Jira issues", "Watch the webinar recording", and "See what Trello can do". | People who are blind or low vision arenāt excluded by these words. They still āviewā a list of items, in a different way. Where it makes sense to do so, avoid these words. You donāt need to remove them if theyāre accurate. |
Enabled/disabled | Disabled isn't an offensive word. It reflects when people are limited by their environment, and society. Avoid associating the word disabled with negative states. Wherever you can, alternatives to ādisabledā, like āturned offā or āunavailableā are good. |
Techniques for inclusive product experiences
Use they/them pronouns, and gender neutral language
When referring to a person, use the pronouns they tell you to use. When referring to a person or a group of people you donāt know, use they/them pronouns. This makes your product experience more gender inclusive.
Example | Alternative | Reason |
---|---|---|
Ask your project admin to enable editing permissions on his or her account. | Ask your project admin to enable editing permissions on their account. | Using they/them pronouns is more inclusive, and easier to read. |
Build inclusive forms
When you gather data about people, remember that pre-defined categories donāt accurately reflect the diversity of our world. Form fields can prevent people from using software if they're unable to fit into the schemas weāve defined for them.
If you need to collect information about peopleās identities, give people the option to choose not to answer, or to give a self-defined answer. When gathering information about names, use a āFull nameā field instead of separating names by first name, last name, and salutation.
Avoid setting any particular group of people as the default option. This implies that other groups are not the norm, not common, or forces them to navigate and configure things more than others.
One way to avoid this is by not asking for more information than necessary. Often detailed personal information isnāt relevant to our products, so ask yourself if you really need people to identify or group themselves before building this into products.
Be accurate
It can be tempting to keep visual labels short, and hide the descriptive information behind an aria-label
. Weāre moving away from this approach, because descriptive language also improves the experience for people who donāt use assistive technology.
Example | Alternative | Reason |
---|---|---|
Ask Atlassian Intelligence about a project or topic within your companyās knowledge base. Learn more | Ask Atlassian Intelligence about a project or topic within your companyās knowledge base. About Atlassian Intelligence | Accurate, descriptive links reduce the cognitive burden we put onto people using our products. For more examples, read alternatives to ālearn moreā (Atlassians only). |
Atlassian Intelligence is great for speeding up your work, and helping you be productive. | Use Atlassian Intelligence to find answers, get summaries, and generate content. | Donāt use vague promotional language. Describing new features with accuracy builds trust and helps people make informed decisions. |
Step 1 | Create project (Step 1 of 3) | Describe tasks accurately, so that people know where they are in their workflow. |
Write helpful examples
It can be tempting to use the example text for form fields or search boxes to add fun and delight to your product or platform.
If your example includes an example company name or task, make sure that these are accurate enough to convey what the example is showing.
Example | Alternative | Reason |
---|---|---|
Ask AI a question, like āShow me all issues in the āDonut Plainsā project.ā | Ask AI a question, like āShow me all issues in the āSnack Delivery Systemā project.ā | Itās okay to make your examples fun, but donāt let specific cultural references make it confusing! Keep it universal. |
Make alt text concise and consistent
If images provide information, always include alternative text (āalt textā). When youāre writing alternative text, consider how that text will change the screen reader experience.
If youāre working on a product experience with elements that are very repetitive, like iconography, donāt make alternative text too wordy as this will make the experience worse for people who use assistive technology. For example:
Not enough information | Too much information | Just right |
---|---|---|
Question mark | Jira customer support question. Created by Jira service desk. | Support question |
If youāre using the same visuals in multiple places, make sure that you use the same alt text every time it appears. The design system helps with this by providing label guidelines for components like modal dialogs and spinners.
Use reference material
Language is changing all the time, so we donāt maintain a list of terms to use or avoid. Use resources like the APA Inclusive Language Guide or AP Stylebook to learn about specific terms. Ā
We've reorganized this website
These guidelines are here to help you use inclusive language when designing products and platforms. You can access the archived global inclusive language guidelines (Atlassians only), these are deprecated and will be replaced in the future.