Efficient Jira Screens and Jira Service Desk Request Forms

When I became a Jira administrator, the most confusing part of project administration was how screens, screen schemes, and issue type screen schemes worked together. Huh? All I wanted to do was to change a few fields around and instead, I found myself lost in a confusing combination of settings that didn’t make any sense to me. Shouldn’t it be easier? Once I understood the relationship however, I saw how powerful these settings are when they work together. Let’s start out with some simple definitions.

Screens

Screens define which fields are present and their display order. Jira Server and Jira Cloud “Classic” projects have four types of screens. They are:

  1. Create: A screen for creating a new issue
    • This screen collects the initial information from the Reporter. It often contains just a few of the most important and required fields.
  2. Edit: A screen for editing an existing issue
    • This screen contains all the fields a user is able to complete or update.
  3. View: A screen for viewing an issue’s details
    • This screen contains all the fields a user is able to view.
    • Note: Jira Server and Jira Cloud “Classic” projects only display fields that have data. For example, if the “Due Date” field is empty, you won’t see it on an issue’s view screen.
  4. Transition: A screen that is displayed during a workflow transition
    • This screen is often used to collect or update data at different points in an issue’s lifecycle. For example, the “Resolution” field value is collected before an issue reaches its final workflow status.
    • Tip: Distinguish your transition screens from other screens by naming them with a “(T)”. Example screen name: Assignment (T). See screenshot.
Image: A transition screen’s name is signified with “(T)”

You can have one screen, or one set of screens, for all issues in your project. Or you can have different screens for each issue type. We’ll talk more about that in the “Issue Type Screen Scheme” section below.

Jira Cloud “Next-gen” projects work differently however. There’s just one screen per project or per issue type and no distinction between the create, edit, and view operations. “Next-gen” projects treat empty fields differently as well. An empty field displays with the word “None” below it, as pictured.

Image: The “Start Date” field is empty, but displayed in a Jira Cloud “Next-gen” project

Fields and Ordering

In all versions of Jira, screens display both standard and custom fields.
Some fields can be ordered as desired by rearranging them on the admin view of the screen.  Other fields are automatically placed and grouped together. For example, all user-picker fields (“Assignee”, “Reporter”, etc) appear together on the right side of an issue’s screen. All date fields (“Due Date”, “Created Date”, “Updated Date”) also appear together on the right.

Screen Schemes

Jira Server and Jira Cloud “Classic” projects have Screen Schemes.
Remember the “create”, “edit”, and “view” operations above? This scheme associates one or more screens with an operation.

In this simple example, there’s one screen for each operation.

Image: The “Epic Screen Scheme” uses the screen called “Epic: Create, Edit and View” for all operations

In this more complex example, there is one screen for the “create” operation and another screen for the “edit” and “view” operations.

Image: The “Bug Screen Scheme” used the “Bug: Create” screen for the create operation and the “Bug: Edit and View” screen for the other operations.

A Screen Scheme can have as little as one screen shared by all operations or as many as three screens, with one screen for each operation.

Why Multiple Screens?

I recommend starting with one screen shared by the “create”, “edit”, and “view” operations in your project. If that screen becomes cluttered with too many fields, or if information needs to be collected during different stages of the workflow, then consider using multiple screens.

Issue Type Screen Schemes

Jira Server and Jira Cloud “classic” projects also have one final setting called an Issue Type Screen Scheme. This scheme associates screens with different issue types. Just like you can have different screens for different operations, you can have one set of screens for your Bugs, one set for your Stories, and another set for your Tasks.

This Issue Type Screen Scheme has two Screen Schemes. The Bug issue type uses the “Bug Screen Scheme” which has two screens. The Epic issue type uses the “Epic Screen Scheme” which has one screen.

Image: The Bug issue type has three bug-specific screens. The Epic issue type has only one epic-specific screen.

Tying it Together

Screens, Screen Schemes, and Issue Type Screen Schemes work together to power your project. Atlassian explains this relationship in this diagram.

It look me a long time to understand these concepts. I recommend you re-read this article and experiment in your own Jira test environment, until the relationship between these settings is clear.

Jira Service Desk Request Forms

If you have Jira Service Desk, there’s another type of “screen” to be aware of. When Service Desk Agents login to Jira, they see the typical Jira screens described above. When Service Desk Customers login to the Customer Portal however, they see request forms.

Request forms provide a simpler and streamlined issue view, which is great for less technical audiences. Customers need no Jira knowledge to use the portal to submit their request.

In the example below, the left image shows a default Jira create screen, which contains 21 fields. The right image shows a default Jira Service Desk change request form, which contains only 10 fields. Which one looks easier to complete?

Image: A Jira change request create screen (left) and a Jira Service Desk change request form (right)

Best Practices

Make your screens and schemes as easy, efficient, and reusable as possible. Here are some recommendations:

As With all Forms

  • Don’t collect data you won’t query on or actually use
  • List fields in the order a user would likely supply the information
  • Order fields consistently between issues types in a project and between projects. Users expect and appreciate a standard.
    • Example: The “Summary” field is always first, the “Description” field is always second, etc.

For Jira Server and Jira Cloud “Classic” Projects

  • Use a single screen for all operations (“create”, “edit”, “view”) until there’s a real need for additional screens.
    • Consider additional screens when there are too many fields or if information needs to be collected during different stages of the workflow.
  • On the “create” screen:
    • Only include the most important and required fields. Too many fields overwhelm users. Too many fields also impacts loading and performance.
    • Only include fields relevant to the Reporter. For example, if a business team member is reporting a Bug, they can’t provide an effort estimate and won’t know which code version is impacted. Don’t show the “Story Points”, “Original Estimate” or “Affects Version” fields. Instead, add these fields to your “edit” and “view” screens. You can also prompt a development team member for that information, later in the workflow, using a “transition” screen.
  • Create a single screen and a single screen scheme, for all issue types, until more are needed.
    • Example: You want the custom fields “Steps to Reproduce” and “Expected Result” on a Bug’s “create” screen, but not on a Story’s “create” screen.
    • Example: Create one standard for all development projects and another standard for support projects, not one custom configuration per Jira project.
  • Create generic screens and schemes so they can be shared between projects.

Other articles in this series:

  • Why Form Design in Jira Matters  –  How you design your forms will impact the quality of data you receive, and much more!
  • Layout and Flow: Creating User-Friendly Forms in Jira – Form layout affects completion rates and user frustration. We’ll discuss the right way to do it.
  • Writing Good Form Questions in Jira: Part 1 – How do you choose the right words, field types and validation levels? This article will dig into the nitty gritty of creating good form questions. 
  • Writing Good Form Questions in Jira: Part 2 – Choice questions are great for collecting structured data. We’ll look at the options for choice questions and discuss ways to influence, or mitigated influence on the user.
  • Things to think about when converting forms in Jira – Bringing a process into Jira for the first time? Don’t just copy forms straight across. This is a chance to make improvements.
  • Efficient Jira Screens and Jira Service Desk Request Forms Jira screens and JSD request forms aren’t the same. Here’s how you can make each one work for its audience.
  • Tips for Creating good forms/screens in Jira – Learn how you can leverage Jira features like tabs, workflow transitions and icons to create better forms and screens.
  • Form Design Best Practices: What you can and can’t do in Jira – Now that we know what good form design means, we’ll hone in on which practices can be applied to Jira and Jira Service Desk
  • Use cases – We’ll also include a series of use cases illustrating how using forms expands what you can do in Jira.
  • Form audit – Finally, we’ll take a bad form and transform it to an awesome, user-friendly, data collecting machine.

Evolution of Jira Design

A better navigation for Jira Cloud is coming soon! While we wait I thought it would be fun to dig up some old screenshots and take an unofficial and outsiders look at how the Jira interface has changed over the years.

When Jira was first released in 2002, it was purely for software development.  But these days, all kinds of teams, like Legal, Marketing, HR, and IT, use Jira to track their work and their team’s “to do” list.  Jira is useful for any industry and it’s not just for software development anymore!

The modern Jira experience is much different than what launched in 2002. Jira has evolved into different application types and different deployment methods. You can choose between Jira Core for business teams, Jira Software for development teams, and Jira Service Desk for support teams. You can also choose Jira Cloud (Atlassian hosted), Jira Server (hosted on-premises, in a data center with your other internal applications, or in a Cloud server environment like Amazon AWS), or Jira Data Center (also self-hosted but built for mission critical environments.)

It’s no surprise that the application’s design, look, and navigation has changed drastically over the years. Here are a few examples of the visual evolution.

In the Beginning

In 2002, Jira looked just like all the other web applications did at the time. As a web developer, I remember web application design closely mirrored desktop application design. It felt like developers were porting their applications to “web format” and wanting them to behave the same way as the PC versions did. User interface standards were just emerging. Websites were mostly grid based and layouts were in box or table format. In the Jira 2002 screenshot example you can see the familiar “logo in the top left header” standard that we all still expect today.

Jira circa 2002. Source: Happy Birthday to the Atlassian Community

In 2007 the logo and header changed slightly but the overall layout remained the same. The issue screen doesn’t yet have the right sidebar to display people and date fields. This design reminds me of what you see today when you export Jira filter results for printing.

Jira circa 2007. Source: Atlassian Marketplace

In 2009 Atlassian acquired GreenHopper which added release planning, burn down charts, and many of the agile features we use today. I still remember installing GreenHopper as an app and when “Agile” was a link in the top nav.

Into the Cloud

In 2011, Atlassian created a cloud-based version of Jira. It looked and functioned just like the self-hosted version. It was originally named “JIRA OnDemand” and the on-prem version was called “JIRA Download.” The names were re-branded in 2014.

Also in 2011, the Jira admin interface received a new project-centric design. I’m very thankful for the quick nav and keyboard shortcuts. I use the “gg” shortcut daily to move around the admin area.

Originally named RapidBoards, Scrum Boards graduated from the labs sandbox and became a standard feature in 2012.

Boards circa 2012. Source: Jira Server 5.10 release notes

Just two years later, the board design looked more polished with assignee avatars, different placement for priority icons and estimates, and improved spacing.

Boards circa 2014. Source: Form nimble agile teams

In 2012, the Atlassian Design Guidelines (ADG) were published to unify the customer experience across products. Hooray for consistency and standards! This meant the typography, spacing, and layout in Jira would be similar in Confluence. Jira 6, released in 2013, was the first “ADG compliant” version.

In 2013, the workflow designer was rebuilt in HTML 5. I remember when HTML 5 was the latest and greatest thing in web development! We all hoped it would replace Adobe Flash. Flash support officially ends in Dec 2020, but I haven’t seen a Flash-based website in years.

Back in 2013, all the workflow statuses were one color. We didn’t see different status categories, colors, or lozenges until version 6.2 in 2015. Different status colors helped end users understand whether they were in the beginning, middle, or end of an issue’s life cycle.

One Color Workflow Statuses
Multi-Color Workflow Statuses

Custom status icons were also eliminated in 2015. Anyone remember those? I don’t think anyone misses them.

Workflow Status Icons

New Designs for new Application Types

In 2015, Atlassian split Jira into two application types: Jira Core and Jira Software. Core featured a simplified interface aimed at business teams. Software retained development-specific features like versions, sprints, and dev tool integration. In the Jira Core screenshot below there are few links in the left nav.

Jira Core circa 2015. Source: Say hello to Jira Core

As the applications diverged, sometimes new features were built in one type but not in the other. For example, Jira Cloud got a new visual roadmap feature and Jira Data Center got archive abilities. Design differences emerged and even some terminology changed. Cloud has a global permission called “Share dashboards and filters” but the same feature in Server is named “Create Shared Objects.” All these small differences are certainly challenging for me. It’s harder to use both application types at the same time and to keep training materials up to date. Even Atlassian has to maintain separate sets of documentation.

In 2016, the atlassian.design domain was registered to house their design principle documentation and brand information. Their style guide is a fabulous example for other organizations to follow. I especially like how easy their logos are to download and the “don’t do this” logo crime samples.

Also this year mobile Jira apps for IOs and Android were launched with their own platform-specific features and design.

Jira Android App. Source: Jira Software for Android has landed
New Jira logo

In 2017, Atlassian re-branded their entire corporate identity introducing a new logo, individual product logos, and renaming “JIRA” to “Jira”. Branding modifications are inevitable as companies grow and change. This is the fifth Atlassian logo change in 15 years. There’s a great graphic showing the logo evolution here. The new logo symbols feel multi-dimensional, fresh, and modern. It will be a long time before I can update every instance of “JIRA” to “Jira” in my book and on my website though!

Jira Cloud UI Overhaul

Also in 2017, Atlassian departed from their previous interface strategy. They announced “Jira Cloud will get an updated look and feel, including a collapsible sidebar navigation and enhanced search, to help your teams get things done faster.” The new nav was completely different from the top horizontal navigation in Jira Server and in previous Cloud versions.

I had trouble finding my way around and noticed more clicks were needed to get to some areas. The large left side bar commanded a lot of visual space. It was collapsible but you’d need to expand it again to access certain links. Sometimes the navigation loaded after the page contents loaded. Most annoyingly, the nav’s vertical scroll bar made it hard to print or screenshot pages. This navigation reminded me of designing with HTML frames in early 2000.

Source: Your teams are getting better navigation in Jira Cloud

Jira Cloud “Before”
Jira Cloud “After”
Bento Box Concept

In 2018, Atlassian took inspiration from the Japanese, Taiwanese, and Chinese bento box to redesign the Jira Cloud issue view. This design divided and grouped key actions and information, much like how rice, meat, and vegetables are separated in individual portions.

Also In Jira Cloud:

Jira Cloud Vertical Workflow

Workflow transitions were simplified. They ware displayed vertically and at the top of the right sidebar.

The separate “view” and “edit” screens were collapsed into a single screen. As such, there’s no “Edit” button and and all fields received inline edit capability.

New search capabilities were added. A keyword search very quickly returned recent issues, boards, projects, and filters. I found myself wishing I could enter simple queries in this search bar.

New Search Function

Clicking an issue from a board opened it in an overlay. When you closed the issue, your board was still there in the background.

Issues Open in an Overlay

Joining the Next Generation

In 2018 Atlassian introduced the concept of next-gen projects for Jira Cloud. This special project type is scheme-less. Project settings aren’t shared and settings don’t impact other projects. The simple configuration interface lets end users quickly create new projects on their own. Read my thoughts on next-gen projects here. Another Cloud feature, Agility boards were also introduced.

The Next-gen interface for adding custom fields and organizing them on screens is simple and intuitive. (Left screenshot below.) But I find the issue screen itself unbalanced. (Right screenshot below.) Most of the fields are stacked on the right side. When there are a lot of fields, they are collapsed and you have to click around to find them. Without a long description, attachment, or comment list, there’s a lot of unused white space on the left.


Jira Cloud Next-gen Project Configuration

Jira Cloud Next-gen Issue
New Workflow Status Colors

Also in 2018, Atlassian split their design guidelines, creating one version for Cloud and one version for Server. The Atlassian Design Guidelines version 3 was published and workflow statuses received new colors.

2020 and Beyond

The new Jira Cloud horizontal navigation launches in March 2020! I’m looking forward to returning to Jira’s navigation roots and what I’m used to. As another user put it “What’s old is “new” again?” Yes, it appears so and I’m very happy about it. Since I use both Cloud and Server, I’m also glad that the nav will be similar again.

Change is the only thing that’s certain. We must all learn to work with it and retrain ourselves and our end users when necessary. I haven’t loved absolutely every change Atlassian has made, but every change is an opportunity (either for me or for them) to learn something new. I’m looking forward to the changes in 2020 and beyond.

While you’re waiting for the new Cloud nav to arrive in your instance, here are some early screenshots of the latest look and feel.

Like Atlassian history? Also read: Summit Through the Years and Jira Cloud Navigation Comparison

Things to Think about When Converting Forms to Jira

The first time I converted a paper form to an online form, I made my online form a perfect replica of its predecessor. I figured the team I was building the form for would appreciate my being faithful to their original and I wanted them to feel reassured that the transition to digital did not mean they had to abandon their processes.

Later I learned that there are several reasons you shouldn’t do that:

  • The form may not have been well designed in the first place.
  • Processes may have changed since the form was last updated.
  • Online forms allow us to use functionality that isn’t available for paper or PDF forms. We can make forms that are better for both the team that owns the form, and their customers/users.

ProForma for Jira

Where to Start When Converting to Jira Forms/Screens

Instead of copying, gather the stakeholders and start from a blank slate. There are several things you should consider before creating your form:

  • Define the user
    Who is the customer/user who will be filling out the form? What are they trying to achieve? Is there information that you’ll be asking for that the customer may not know how to find? Or information that they may not want to provide? Are there parts of the current form that customers frequently get wrong? What do you know about your users language level (Are you creating the form in their native language? Are you using technical terms or jargon they may not be familiar with?) 
  • Decide what information you need to collect
    List the data points that need to be collected. Be willing to challenge the status quo. Since one of the principles of well-designed forms is minimalism, put every element (section, question, instruction) on trial for its life. If no one can justify why the data is needed, then ditch the question. 
  • Note which data points need to be collected from which users
    There’s a good chance that you don’t need to ask every user every question. Note which questions are associated with certain scenarios. You’ll use this information later to make some questions conditional, thereby making the form shorter and easier for users.
  • Decide when and where to place instructions
    Large blocks of text are annoying and often ignored by users. Move as much instruction as possible to the field level.
  • Identify validation and formatting needs
    Get clarity on what’s required and what’s optional. Find out if there are any business rules (choice options, spending limits, etc.) that should be built into the form. Also, find out if there are preferred formats for text fields. Consider whether any of the fields should have a default value.
  • Isolate the data points that will be queried/reported on
    While you’re still with the form’s stakeholders, find out which of the information points identified in step 2 will be used in queries and reports. Many data points are collected in order to provide a service, but are never queried. Sorting your data points into to camps will help you select the right field types and keep from creating unnecessary Jira custom fields.
  • Locate the form in the business process
    Where does the form fit in the workflow? Are there circumstance where the form should be automatically added to the issue? What should happen once the form is submitted? Is the form part of a compliance strategy?

Create Your Form/Screen in Jira

Now you’re ready to create you screen/form. Remember to:

  • Follow the rules of layout and flow to create a user-friendly form.
  • Avoid creating new Jira custom fields unless absolutely necessary.
    Be judicious about creating new Jira custom fields. An over-abundance of custom fields makes your Jira configuration complex and will eventually degrade Jira performance.  A new custom fields should not be created unless it:
    • Can be used by multiple projects
    • Will be queried and reported on
    • Does not duplicate Jira functionality or an existing custom field

Try to use other options such as a ProForma field, a field configuration, or a field context.

  • Make the most of the functionality offered by online forms.

By engaging in a careful discovery process and employing the rules of good form design, you can help teams maximize usability and efficiency as they bring their processes into Jira.

Other articles in this series:

  • Why Form Design in Jira Matters  –  How you design your forms will impact the quality of data you receive, and much more!
  • Layout and Flow: Creating User-Friendly Forms in Jira – Form layout affects completion rates and user frustration. We’ll discuss the right way to do it.
  • Writing Good Form Questions in Jira: Part 1 – How do you choose the right words, field types and validation levels? This article will dig into the nitty gritty of creating good form questions. 
  • Writing Good Form Questions in Jira: Part 2 – Choice questions are great for collecting structured data. We’ll look at the options for choice questions and discuss ways to influence, or mitigated influence on the user.
  • Things to think about when converting forms in Jira – Bringing a process into Jira for the first time? Don’t just copy forms straight across. This is a chance to make improvements.
  • Efficient Jira Screens and Jira Service Desk Request Forms Jira screens and JSD request forms aren’t the same. Here’s how you can make each one work for its audience.
  • Tips for Creating good forms/screens in Jira – Learn how you can leverage Jira features like tabs, workflow transitions and icons to create better forms and screens.
  • Form Design Best Practices: What you can and can’t do in Jira – Now that we know what good form design means, we’ll hone in on which practices can be applied to Jira and Jira Service Desk
  • Use cases – We’ll also include a series of use cases illustrating how using forms expands what you can do in Jira.
  • Form audit – Finally, we’ll take a bad form and transform it to an awesome, user-friendly, data collecting machine.

Good Form Questions in Jira: Part 2 – Choice Questions & Conditional Logic

Questions and input fields are the heart of every form. In the previous article, we started digging in on the do’s and don’ts of creating good form questions. Now we’re going to take a closer look at a particular set of field types – choice questions.

The Power of Choice

There’s a lot to be said for choice questions. Choosing from a predetermined set of options is fast for the user. They don’t have to imagine what the possible answers might be, and they don’t have to spend their time typing.

If choice questions are good for the user, they’re awesome for the form owner and the database. They provide structured data that’s easy to aggregate, analyze and report on. They can also be used to trigger automation or conditional logic. As always, think about why you’re asking the question as you decide on field types, wording, and context.

Field Types for Choice Questions in Jira

There are multiple options for creating choice questions: Jira offers:

  • Checkboxes
  • Radio buttons
  • Select lists (single, multiple and cascading)
  • Picker fields (date, date and time, group(s), project, user(s), version(s).

ProForma includes:

  • Check boxes,
  • Radio buttons
  • Dropdown boxes
  • Pickers (date, time, date and time and user(s); ProForma also lets you create your own user picker fields by creating data connections that populate choice lists from an external source.

Determining which field type to use should be based on:

  • Whether you want users to select one option only (radio buttons, dropdown, single choice select list), or more than one option (checkboxes, multiple choice select lists).
  • Layout and available space on the form/screen – Radio buttons and checkboxes are fastest for users because they can see all of the choices at once, no extra clicks required. However, if you’re option list is excessively long, dropdown boxes let you save space on the screen.

Since choice questions already limit the user, when choosing field types it’s good practice to use the least restrictive option. Radio buttons, single select lists and dropdown boxes mean the user can only select one option. If there’s any possibility that the user would want to select more than one option, use check boxes or a multiple select list.


I use Chrome for work and Firefox for personal use, but the question only allows me to select one. The question should be narrowed (“Which browser do you use most often for work?”) or should be a check box field type to allow the user to select more than one option.

Things to Consider When Creating Choice Questions

  • Make Sure Everyone Can Respond
    The limitation of choice questions, is that they are closed.  While this may be helpful to the form owner, it can be frustrating for the user. What if what they really want to choose isn’t listed as an option? One advantage of using ProForma is that it allows you to include an “Other” option, with an adjoining text field on your choice lists. Depending on how your question is phrased, it may be appropriate to offer options such as “I don’t know,” or “Not applicable”. The important thing is to make sure that your choices offer every user the opportunity to provide an honest answer.
  • Structure Your Rating Scales
    Choice questions are often formatted as rating scales (strongly agree > strongly disagree, etc.) to measure user’s opinions or satisfaction. Carefully consider if you want an even or odd number of options. An odd number of options gives the user a chance to be neutral, while an even number forces them to give an opinion. (If you’re not going to make the user give you an opinion, is it really worth including the question?)
    • Label each point in your scale with words, so users don’t have to take the extra mental step of translating numbers into another meaning. Scales should not be too large, and the increment (in meaning) between each point on a scale should be equal.
    • Points on a rating scale can either go from “lowest” to “highest” or vice versa. Scales are frequently structured with the most positive response listed first because users ofter select the first option they see. The important thing is to be consistent throughout your form.
  • Avoid Double-Barreled Questions
    Since the purpose of a form is to obtain structured data, it’s important that each question asks only one thing. This is especially true for choice questions. Otherwise, you’ll end up with a bunch of easy-to-categorize answers and have no idea what they refer to. Customer satisfaction surveys that ask you to agree or disagree with statements like, “The agent I spoke to was friendly and knowledgeable,“  miss the mark. What if the agent I spoke to was kind, but clueless?
  • When a Choice Really Isn’t a Choice
    Sometimes we use choice questions when we’re really not offering the user a choice. The user has to say yes if they want to continue the process. In these cases, a checkbox is the correct field type since we are not excluding other options. In a previous article, I said that if you want users to read your instructions, you should avoid big blocks of text. The opposite is also true: If you want your users not to read something, make it long and full of jargon. John Oliver does a great job of describing how effective this is.

Choice Architecture

As with all form questions, you’ll want to use concise and unambiguous language. But creating good choice questions requires additional considerations. How you frame your questions can impact how users respond. This is called choice architecture. You may want to use it your advantage, or you may want to try to limit your influence to get a more “pure” response from your users. 

The Influence of Defaults

One of the first decisions you’ll need to make is whether or not to include defaults. Defaults save time for the user. They also nudge the user in a certain direction. Users may perceive the default options as being recommended (after all, that’s what everyone else is choosing). In some cases, the default option may even be labeled as recommended. Even when logic doesn’t tell us to leave the default, inertia often does. We’re happy to avoid making a decision.

The most frequently cited examples of this mechanism at work are the differences in organ donation rates (cited in the first article of this series) add image and the use of “opting in” to get employees to contribute to retirement savings account. Parting with your organs, or your money, is a serious decision. Yet the evidence shows that many of us are happy to simply follow the default’s lead.

If you feel really confident that you know what the vast majority of users would want, use a default. If you want to encourage your users to make a certain choice, use a default. If you want to get more impartial data from your users, don’t use a default. Be cautious about offering a default for a required field. If the field is important enough to be required, you probably want your users to consider their answers, which they are less likely to do if a default is provided. 

Choice Order Changes Results

Even if you don’t use a default, some bias will be built into your choice questions simply because you have to list the options in some kind of order. Inundated with information, our brains have learned to scan, which means we’ll pay more attention to the first and the last item in a list.  In most cases, it’s sufficient to just put your choice options in some kind of logical order (lowest to highest, alphabetical, etc.). This makes it easy for the user to find the option they’re looking for. However, if you want to truly minimize the influence of the first/last bias, you need to randomize your choice options.

How Framing & Decoy Affects Impact Responses

How your question is perceived will be impacted by the words you choose. Here’s a example that frequently comes up when buying an airline ticket:

The words have been chosen carefully. Including the price of the flight reminds the user of the investment they’ve already made and makes the price of the insurance seem insignificant by comparison. The word “risk” also pushes the users towards buying the insurance.

In addition to wording, visual cues can be used to nudge a user to a certain choice.  Here’s an example from Atlassian.

The Cloud option has an eye-catching button, while Server is a simple text link. Cloud is also the option on the left, where we usually find buttons like Save and Publish, as opposed to the right where we often see Cancel.

Another common practice is to make an item seem more appealing in comparison with the other choices on the list. This strategy is commonly seen on eCommerce sites.  Personali™ offers this example from BestBuy.com.  Compared to the $1,000 camera, the $45 memory card seems cheap.  However, if the user were to search the site for memory cards, they’d find equivalent options at a much lower price.


Image courtesy of Personali

It should be noted that, as with the examples of organ donation and employee retirement contributions, these kinds of strategies can be used for the user’s benefit, or – as with the examples from Best Buy and Atlassian – to push a product. The important thing is to be aware that when you create choice questions, you can (and frequently are) building in a bias. Therefore, you need to structure and word your choice questions carefully.

Conditional Logic

Along with being fast and easy for the user, and producing nice clean data for you, choice questions allow you to use conditional logic. Conditional logic allows you to dynamically show or hide form questions based on a user’s response to a previous question. This allows you to:

  • Reduce cognitive overload for the user – the form looks less cluttered, less overwhelming.
  • Shorten the user’s path to completion – the user only sees the parts of the form that are relevant to them. There’s no confusion about which parts they are supposed to fill out.
  • Use one form for multiple, similar use cases.
  • Accommodate edge cases.

Let’s look at a few examples.

An HR department is using Jira Service Desk to manage Personnel Action Notifications.

When the form first loads it looks
like this:
Other questions appear depending on what items need to be changed.

Conditional logic is one of the biggest advantages electronic forms have over paper forms. It’s also one of the best things you can do to make your forms more user-friendly – especially customer-facing forms on the JSD portal.

The ability to create forms in Jira, without dozens of custom fields or complex configurations, makes Jira and JSD a viable options for non-tech teams.

In our next article, we’ll look at things you should consider when helping those teams (or any team) bring their existing forms into Jira.

  • Why Form Design in Jira Matters  –  How you design your forms will impact the quality of data you receive, and much more!
  • Layout and Flow: Creating User-Friendly Forms in Jira – Form layout affects completion rates and user frustration. We’ll discuss the right way to do it.
  • Writing Good Form Questions in Jira: Part 1 – How do you choose the right words, field types and validation levels? This article will dig into the nitty gritty of creating good form questions. 
  • Writing Good Form Questions in Jira: Part 2 – Choice questions are great for collecting structured data. We’ll look at the options for choice questions and discuss ways to influence, or mitigated influence on the user.
  • Things to think about when converting forms in Jira – Bringing a process into Jira for the first time? Don’t just copy forms straight across. This is a chance to make improvements.
  • Efficient Jira Screens and Jira Service Desk Request Forms Jira screens and JSD request forms aren’t the same. Here’s how you can make each one work for its audience.
  • Tips for Creating good forms/screens in Jira – Learn how you can leverage Jira features like tabs, workflow transitions and icons to create better forms and screens.
  • Form Design Best Practices: What you can and can’t do in Jira – Now that we know what good form design means, we’ll hone in on which practices can be applied to Jira and Jira Service Desk
  • Use cases – We’ll also include a series of use cases illustrating how using forms expands what you can do in Jira.
  • Form audit – Finally, we’ll take a bad form and transform it to an awesome, user-friendly, data collecting machine.

Good Form Questions in Jira: Part 1

Questions, and the input fields that collect their answers, are the heart of every form. Getting your questions right, will mean getting your data right. Well designed questions also minimize frustration for the user. You’ll need to decide what field types to use, what context to provide, how to word your question and how much validation to include. Think about why you’re including each question. What data are you hoping to get? Then consider the user’s point of view. How should you create the question in order to make it easy for them to respond with the data you’re looking for?

Open vs Closed

Questions come in two general varieties, open and closed. Open questions (text fields) let the user type in what they want to tell you. Closed questions (check boxes, combo boxes, pickers and radio buttons, select lists) let the user choose an answer from options you provide.

They each have their advantages. Closed questions are good for users because they are easier to interpret and quick to fill out. They’re good for you because data comes into your database in nice categories, with consistent formatting. Data from closed questions is easy to aggregate and report on.

Open questions are more work for the user. They have to interpret what you’re asking, decide what they want to say, and then type it in.  However, open questions ensure that the user has a chance to say what they want to say. The user may be looking for an opportunity to tell you something you didn’t think to ask. While open questions don’t make for tidy reports, they allow users to provide information which can lead to disruption, innovation and continuous improvement. If your forms use purely closed questions, you may force the user and a service agent to comment back and forth in order to get important details.

Finding the right balance of open and closed questions will depend on the purpose of your form. Consider including at least one open question on your form. This could be an overview question up front – like the Description field in Jira – or an optional “Comments” field at the end. You can also mitigate the restrictiveness of closed questions by including an “Other” option. (We’ll dive deeper into closed questions in the next article.)

Asking Good Questions

Teachers are fond of saying that there’s no such thing as a stupid question. I beg to differ. Stupid questions are questions that don’t ask what you want to know, or questions that try to ask too many things at once.

Whenever I call my credit card company I immediately get a follow-up email that asks:

The first part of the question indicates that they want to know if I’m happy with the customer service I received, but the second part of the question asks something completely different. The question is either:

  • Using the wrong metric to measure customer service;
  • Or, trying to ask two different things at once.

Personally, I would never choose or recommend a credit card based solely on customer service. Other factors – interest rates, cash back and annual fees play a big role.  Since I’m middle-aged my friends and family members have already found credit cards that work for them. Giving an honest answer to the question might reflect badly on a perfectly competent agent who took my call. The result is that, unless I received really bad service, I don’t answer the question.

Resist the temptation to use double-barreled questions as a strategy for keeping your forms short. Yes, you want to be brief. That’s why you’re only asking questions you really need the answers to. But if you lump two questions into one, you won’t know which part the user is answering. The agent and the user will have to exchange comments back and forth to clarify, and you’ll end up taking up more of the user’s time than you would have if you’d just included two questions in the first place.

Language

How you word your questions matters.  Choosing unambiguous wording will mean reduced frustration for your users, and fewer errors in the data you receive. When writing form questions:

  • Know your audience
    The language you use should fit your audience. If your form is for the general public, remember that not everyone has the same literacy level.  Use plain language – short sentences and everyday words.

    What if the general public isn’t your audience? Reading through postings in the Atlassian Community, I notice that many participants are highly technical, but may not be native English speakers. Writing for this audience, I might choose a longer, more formal word that has a latin root (thus recognizable to speakers of other latin-based languages) over a shorter, more common word. It’s all about who you’re creating the form for.

  • Provide context
    Organizing your questions into logical sections will help provide context for the user. Depending on what you’re asking, that may or may not be enough context. Remember that the user doesn’t know what you know.

    Field level help text is a great opportunity to provide more context. Including an example can help the user understand what kind of response you’re looking for.
ProForma for Jira

Rachel Wright provides examples on her Custom Workflow Documentation form.

If you’re asking a question that can seem intrusive, tell the user why you’re asking and how the data will be used. 

Finally, if you’re asking for information the user may not know how to find, help them out. For example, tell them where to find a version number for their software or a serial number for their hardware. You can put this information directly in your field help text, or use your help text to point to another page with detailed instructions.

  • Use neutral words
    If you’re truly trying to get the user’s opinion, then strive for neutral wording. The words you choose can influence the answer, so avoid phrases that indicate what you think the correct answer should be. And if you’re wondering what leading questions look like, grab a political survey put out by a political party.

    You’ll also want to avoid using absolutes – words like all, always, never, etc.  Including an absolute means you will find the exceptions that prove the rules. You can improve your questions by simply deleting those words. 

Getting Text Fields Right

While text fields collect responses to “open” questions, that doesn’t mean that you don’t have any control of the data you receive. Using appropriate field types, formatting and validation will ensure you get data you can use, while still allowing users the flexibility they need. 

Field Size and Type

Text fields are not one size fits all. When choosing the size of your text fields (two options in Jira, three options in ProForma) remember that the size of the field should be proportional to the amount of text you want the user to input.

Text fields also come in many varieties. Along with various sizes (single line, multiple line/paragraph), there are also number fields, email fields, url fields, etc.  These fields have been formatted and validated behind the scenes to ensure that the user can only enter certain kinds of information. Using the correct field type means better data that can be used for other functions later (perform calculations with number questions, export a spreadsheet of email addresses to make a contact list, etc.).

Pattern Matching

You can also create your own text field types using ProForma’s Regex feature. Regex allows you to create text patterns that the user’s input must match.  These can be simple or complex expressions, and are a great way for collecting properly formatted data. Regex patterns are often used for collecting:

  • Account numbers
  • Phone numbers
  • IP addresses
  • Currency amounts
  • References to ISO standards 
  • Serial numbers

Note that you’ll want to tell your users what patterns the field accepts. Use field level help (the Description property in ProForma) to provide instructions and examples.

ProForma for Jira

Validation

Finally, deploying validation rules – such as word/character limits and value limits for number fields – not only ensures clean data, it allows teams to build their business rules into their forms. As above, you can save time and frustration for your users by letting them know, either in the question itself or in the help text, what the limitations are.

Following the advice above will help make your text questions easier for your users to understand and respond to. However, chances are good that most of the fields on your forms will be choice questions, so we’ll look into the best practices for creating choice questions in the next article.

Other articles in this series:

  • Why Form Design in Jira Matters  –  How you design your forms will impact the quality of data you receive, and much more!
  • Layout and Flow: Creating User-Friendly Forms in Jira – Form layout affects completion rates and user frustration. We’ll discuss the right way to do it.
  • Writing Good Form Questions in Jira: Part 1 – How do you choose the right words, field types and validation levels? This article will dig into the nitty gritty of creating good form questions. 
  • Writing Good Form Questions in Jira: Part 2 – Choice questions are great for collecting structured data. We’ll look at the options for choice questions and discuss ways to influence, or mitigated influence on the user.
  • Things to think about when converting forms in Jira – Bringing a process into Jira for the first time? Don’t just copy forms straight across. This is a chance to make improvements.
  • Efficient Jira Screens and Jira Service Desk Request Forms Jira screens and JSD request forms aren’t the same. Here’s how you can make each one work for its audience.
  • Tips for Creating good forms/screens in Jira – Learn how you can leverage Jira features like tabs, workflow transitions and icons to create better forms and screens.
  • Form Design Best Practices: What you can and can’t do in Jira – Now that we know what good form design means, we’ll hone in on which practices can be applied to Jira and Jira Service Desk
  • Use cases – We’ll also include a series of use cases illustrating how using forms expands what you can do in Jira.
  • Form audit – Finally, we’ll take a bad form and transform it to an awesome, user-friendly, data collecting machine.

Layout and Flow: Creating User-Friendly Forms in Jira

There are two things we know for sure about forms – One: everyone fills out forms, and two: no one likes filling out forms.  With that in mind, your goal in designing the layout of your forms should be to help the user get through the form quickly and easily while providing accurate information.

With multiple options for label placement, help text placement, validation, action buttons and page layout – webforms provide multiple ways to pose questions to users. For the purpose of this article however, we’ll be focusing on Jira forms. We won’t get into the weeds about whether or not your labels should be above or to the left of your input fields, because Jira doesn’t offer options on all of those details.

Instead, we’ll focus on three big principles – minimalism, logical structure, and a clear path to completion – that will ensure your forms (Jira screens or ProForma forms) are as user-friendly as possible. Rather than thinking in terms of what information we need, we will look at the problem from the user’s point of view. Who are your users? What are they trying to achieve by filling out the form?

Let’s get started.

Principle 1: Minimalism

Less is more when it comes to forms. Our brains are subject to cognitive overload. If too much comes at us at once, we’re unable to process it. We don’t have the RAM. So keeping forms decluttered makes it easier for users to complete them.

Reduce the number of questions you ask

The first thing you can do to make sure your forms are as minimal as possible is to prune back the number of questions you ask. To ensure you’re only asking what you really need to know, either start from a blank slate, or – if you’re working from a template – put every question on trial by considering:

  • How is this information used?
  • Is it necessary in order to provide the user with what they want?
  • Do we already have this information somewhere else?
  • Can we use conditional logic to ensure that the questions is only shown to the right users?

If you don’t need the information, don’t ask for it.

Simplify the language of your question

You’ll also want to be minimal in how you ask your questions. We’ll be delving into the details of question types and wording in the next article. For now, suffice it to say that your question labels should be concise. Use just as many words as needed to avoid ambiguity. You’ll also want to be sure that the language you use fits your audience. If the form is for customers, use plain language. If it’s for technical users, you can use more technical language.

Keep the extras to a minimum

Finally, keep visual extras (color, images, etc.) to a minimum.  Color can be a good option for making important things standout, but only if there’s not too much of it. The same is true for icons.  Other than branding, only include images if they help clarify things for the users. Reserve red text for error and validation messages.

Atlassian has been working to reduce cognitive overload when viewing Jira issues…

Jira then…

Jira Server circa 2007

Jira now…

Jira Cloud circa 2019

Make optional questions, optional!

You can still pose optional questions. But if it’s not information you need to have to provide the service, then wait and ask it later. In Web Form Design: Filling in the Blanks, Luke Wroblewski cites research indicating that users are more willing to answer optional questions if they’re posed after the initial form has been completed. With ProForma, you can automatically add a supplementary form when the initial form is completed. Alternatively, you can create a customer satisfaction survey in Jira to collect more information (See page 19 of Rachel Wright’s Jira Strategy Admin Workbook for instructions on deploying a minimal customer satisfaction survey in your Jira support project.).

Principle 2: Logical Structure

Now that you’ve decided what needs to be included on your form, you have to decide how to arrange it. 

Your forms will be a lot more user-friendly if you think of them as one side of a conversation, rather than as a way to get info into your database.

Group questions into sections

A conversation usually starts with easy, non-intrusive questions. Questions in a conversation are grouped around larger topics, and they follow each other in a natural sequence. There are also natural breaks when a conversation shifts to a new topic. You can recreate that in your forms by grouping questions into sections, and by putting those sections – and their respective questions – in a logical order. This will provide context, making it easier for the user to understand what you’re asking for.

Keep introductory text to a minimum

Keep initial instructional text at the beginning of your form to a minimum. If it’s a big block of text users won’t read it anyway. Instead, provide general instructions in their corresponding sections, or better yet, use field-level help tips. Keeping the instructions close to the questions they refer to will eliminate confusion for the user.

There’s one important exception to this rule. It’s good to let people know up front what they will need, and if there are any eligibility criteria. Webforms also frequently include a “gateway” page or instruction section at the beginning for this purpose.  Here’s an example:

“What You’ll Need” pages and eligibility pages save users time. 
Image courtesy of Rosenfeld Media

Use Pages, Tabs or Sections

Online forms often use multiple pages to organize the form into manageable parts. While we don’t have this capacity in Jira, you can organize questions onto different tabs. Similarly, ProForma lets you include multiple forms on an issue, making it easy to break up data collection into logical parts.

As above, if your form is embedded in a webpage, you can include a “thank you” page at the end that let’s the user know the form has been successfully submitted, and advises them about the next step in the process.

Principle 3: Clear Path to Completion

Since we know that no one likes to fill out forms, one thing we can do to lessen resistance and procrastination is to make it clear to the user how to get to the end. There are a few strategies you can use to illustrate a clear path to completion:

Consistency 

If your team publishes a lot of different forms, use a consistent style when it comes to format, grouping questions, and the overall structure of your forms. This will make the forms feel familiar, and therefore less intimidating to your users.

Be upfront 

If the user is going to need information that they’re not likely to have in their head, let them know upfront. Having to leave a task in progress to dig up needed info is frustrating for your users. It also provides a great opportunity for the user to abandon the process all together.

Easy to scan 

You can also help users know what to expect by putting section titles in title case. (Section titles are also an item where you may want to use color.) Drawing the eye to section titles makes it easy for users to scan, letting them know what kind of questions to expect.

Vertical alignment 

Finally, unless you’re asking for information that demands to be in a grid (e.g. budgets), keep your input fields in a straight vertical line. This makes it easy for the eye to see how to get to the end of the form. The path to completion is like a literal path – if it’s straight you can see where you’re going. If it’s full a switch backs it’s hard to know where you’re going or when you’ll get there.


“Switch backs” image courtesy of Rosenfeld Media

“Literal path” image courtesy of Rosenfeld Media

Creating a clear path to completion, using a logical structure and being as minimal as possible will make your forms more user-friendly and reduce the time needed to complete them. This will improve the quality of the data you receive. Of course, the real nitty-gritty detail of getting good data depends on asking good questions. We’ll dive into the details of form questions in the next article.

Other articles in this series:

  • Why Form Design in Jira Matters  –  How you design your forms will impact the quality of data you receive, and much more!
  • Layout and Flow: Creating User-Friendly Forms in Jira – Form layout affects completion rates and user frustration. We’ll discuss the right way to do it.
  • Writing Good Form Questions in Jira: Part 1 – How do you choose the right words, field types and validation levels? This article will dig into the nitty gritty of creating good form questions. 
  • Writing Good Form Questions in Jira: Part 2 – Choice questions are great for collecting structured data. We’ll look at the options for choice questions and discuss ways to influence, or mitigated influence on the user.
  • Things to think about when converting forms in Jira – Bringing a process into Jira for the first time? Don’t just copy forms straight across. This is a chance to make improvements.
  • Efficient Jira Screens and Jira Service Desk Request Forms Jira screens and JSD request forms aren’t the same. Here’s how you can make each one work for its audience.
  • Tips for Creating good forms/screens in Jira – Learn how you can leverage Jira features like tabs, workflow transitions and icons to create better forms and screens.
  • Form Design Best Practices: What you can and can’t do in Jira – Now that we know what good form design means, we’ll hone in on which practices can be applied to Jira and Jira Service Desk
  • Use cases – We’ll also include a series of use cases illustrating how using forms expands what you can do in Jira.
  • Form audit – Finally, we’ll take a bad form and transform it to an awesome, user-friendly, data collecting machine.

Form Design in Jira Matters

Let’s just admit it. Forms aren’t sexy. They aren’t exciting or innovative. Few people would call them fun. They are, however, important and few business tools have proven to be as enduring. 

The move from paper to electronic forms, and then to online forms solved a lot of problems. We no longer have to contend with illegible hand-writing and necessary fields that were left blank. But the advent of online forms also presents a challenge. How can we best use the tools we have – validation, conditional logic, auto-formatting – to truly optimize our forms so that teams get the information they need and users have a painless, possibly even pleasant, experience?

Forms and screens that serve as electronic forms (I’ll be using the terms forms and screens interchangeably) are more than just vehicles for data collection. They are the first step that gets the ball rolling on most business processes. They are also one of the primary ways we interact with our internal and external customers. And they are a mechanism for influencing (whether we want to or not) human behavior. Combining forms with a powerful workflow engine like Jira is a great way to get work done. Ensure that your Jira forms are well-designed and you’ll do more than get work done. You’ll save resources, improve relationships and influence user actions in the right direction.

Your Jira Forms Drive Data Quality

We create forms for collecting data, and the quality of the form will go along way towards determining the quality of the data. With the creation of every issue type and every request type, you are making decisions – which fields to include on which screens, what order to list the fields in, what justifies the creation of a new custom field – that will impact the quality of data you receive. In turn, getting better data will allow you to:

  • Provide better, faster service – Imagine if all of your Jira Service Desk agents could provide one-touch service, receiving all of the information they need on the initial request and responding to the customer to let them know that issue has been resolved. There’s no going back and forth to collect the missing pieces. No digging through comment chains, no trying to parse out multiple data points that have been lumped together in a description field – all of the needed data is there, where agents can find it. Requests move through the queue faster, pleasing customers and allowing agents to focus on higher value work.
  • Refine your processes – We often create our processes to accommodate the limitations of what we know or what our software can do. Jira is super flexible, but configuration can become complex.  Using well-designed forms that embed in Jira issues allows you to reduce the number of issue types (the work of capturing specific pieces of data is shifted from the issue to the form), simplify workflows (use checklists instead of additional statuses or subtasks) and prune back that jungle of Jira custom fields. Your Jira instance becomes less complex,  and your Jira administrator less burdened. Shifting from custom fields to form fields will also improve Jira performance. 
  • In JSD, being able to easily create portal forms tailored to capture the information needed for each request type allows you to better organize your queues, channeling work to the agent best equipped to handle the request.
  • Enhance Compliance – Forms can serve as a record, capturing and preserving data from different sources, at different points in time, enhancing compliance and accountability. A well-designed form will make it easy to provide management with useful reports, and auditors with the information they need. Adding multiple copies of a well-designed form to a Jira issue allows you to see not only the current state of an issue, but also the discoveries that have been made along the way.
  • Improve the Bottom Line – What is the cost of bad data? How much time do service agents, Jira users and customers loose searching for information that’s hard to find, invalid or missing? Include a field to capture a document version number on a form and the agent can glean the data at a glance. Obtaining the same information through a comment can cost hours, as the request sits, waiting for the customer to come back with needed data. Later, when the agent goes to retrieve the information combing through a comment chain can be like going down a rabbit hole. Better forms lead to better productivity.

Forms are the Basis of Relationships

A form can be the start of a beautiful friendship. Or not. When you consider how many business processes start with a user filling a form, it’s amazing that more attention isn’t given to form design as part of managing customer relations.

Most business processes start with a form. That means that the form is often your one and only chance to make a first impression.  In some cases, government bureaucracies come to mind, a form or forms may be the only way customers interact with an organization. If the forms are bad, the relationship won’t be good. Bad forms can result in users postponing, abandoning and sometimes bypassing key processes.

On the other hand, well-designed, intuitive, user-friendly forms can reduce friction, build rapport and help set appropriate expectations. The improved service that results from good data collection will inspire confidence. Your forms build your reputation and promote your brand.

Form Design Influences Behavior

How we design our forms – the words we choose, the presence or absence of default values, the order of choice options – influence users decisions. If that sounds far fetched consider the image below illustrating organ donation enrollment in Europe.


Source: Why BI?

The stark difference between the rates for the countries listed on the left and those listed on the right isn’t due to culture or religion. It’s the difference between opting in and opting out. Want to increase employee participation your retirement contribution program? Change the form? Want to see more customers opt for a higher value product? Change the form.

We’ll be discussing how you can use wording, question framing, defaults and choice architecture to influence user choices in a future article. And if you’re thinking, “Wait, that’s manipulative. I don’t want to do that,” we’ll also discuss how you can mitigate the influence of your questions on users choices (though it’s not possible to be 100% neutral).

Where Do We Go From Here?

Once you’re convinced that form design matters, what’s the next step? Start by reframing how you think about the form process.

The Behavioral Economics Team of the Australian Government recently introduced the WISER framework for form design. It lays out specific steps to go through in identifying the form’s audience, providing appropriate instructions, using a clear layout, etc.

Source: FORM-A-PALOOZA 2019

There are two big things you should notice about the WISER framework.  First, the framework focuses on the user’s point of view. Who are the users? Why should they complete the form? What information will they need? What language will they understand?

Second, the framework tells us to test and repeat. You wouldn’t adopt a “set it and forget it” attitude towards developing software, so don’t do that with your forms either. Form design needs to be iterative.

Keep those things in mind as we move forward. Over the next few weeks, we’ll be taking a deep dive into form design, discussing the details of form layout, good questions, and things to think about form-wise when you bring an existing process into Jira for the first time. Then we’ll bring in our friend and Jira super-user, Rachel Wright, to discuss how you can apply these concepts in Jira.

Keep an eye out for the upcoming articles in the series:

  • Why Form Design in Jira Matters  –  How you design your forms will impact the quality of data you receive, and much more!
  • Layout and Flow: Creating User-Friendly Forms in Jira – Form layout affects completion rates and user frustration. We’ll discuss the right way to do it.
  • Writing Good Form Questions in Jira: Part 1 – How do you choose the right words, field types and validation levels? This article will dig into the nitty gritty of creating good form questions. 
  • Writing Good Form Questions in Jira: Part 2 – Choice questions are great for collecting structured data. We’ll look at the options for choice questions and discuss ways to influence, or mitigated influence on the user.
  • Things to think about when converting forms in Jira – Bringing a process into Jira for the first time? Don’t just copy forms straight across. This is a chance to make improvements.
  • Efficient Jira Screens and Jira Service Desk Request Forms Jira screens and JSD request forms aren’t the same. Here’s how you can make each one work for its audience.
  • Tips for Creating good forms/screens in Jira – Learn how you can leverage Jira features like tabs, workflow transitions and icons to create better forms and screens.
  • Form Design Best Practices: What you can and can’t do in Jira – Now that we know what good form design means, we’ll hone in on which practices can be applied to Jira and Jira Service Desk
  • Use cases – We’ll also include a series of use cases illustrating how using forms expands what you can do in Jira.
  • Form audit – Finally, we’ll take a bad form and transform it to an awesome, user-friendly, data collecting machine.

Better Form Design in Jira (Series)

In 2017, ThinkTilt and Rachel Wright teamed up with the goal of helping business teams get more out of Jira and conquer their “to do” lists. In 2018, we helped administrators effectively manage Jira and battle custom field bloat. Now, we’re collaborating again to help you create better screens and forms in Jira and Jira Service Desk.

In our upcoming series, we’ll help you understand how form design can help or hinder data collection. We’ll help you write good questions, choose the right custom fields, and create forms that users actually want to complete. We’ll explore the screen and form capabilities of Jira, Jira Service Desk, and ProForma. Finally, we’ll provide use cases for various teams and turn bad forms into good ones.

Our first article tackles the differences between screens in Jira and forms in Service Desk. It’s important to understand how screens, screen schemes, and issue type screen schemes work together. Then, you can map screens to issue types and leverage JSD and ProForma forms.

We hope you’ll check in regularly to see the upcoming installments:

  • Why Form Design in Jira Matters  –  How you design your forms will impact the quality of data you receive, and much more!
  • Layout and Flow: Creating User-Friendly Forms in Jira – Form layout affects completion rates and user frustration. We’ll discuss the right way to do it.
  • Writing Good Form Questions in Jira: Part 1 – How do you choose the right words, field types and validation levels? This article will dig into the nitty gritty of creating good form questions. 
  • Writing Good Form Questions in Jira: Part 2 – Choice questions are great for collecting structured data. We’ll look at the options for choice questions and discuss ways to influence, or mitigated influence on the user.
  • Things to think about when converting forms in Jira – Bringing a process into Jira for the first time? Don’t just copy forms straight across. This is a chance to make improvements.
  • Efficient Jira Screens and Jira Service Desk Request Forms Jira screens and JSD request forms aren’t the same. Here’s how you can make each one work for its audience.
  • Tips for Creating good forms/screens in Jira – Learn how you can leverage Jira features like tabs, workflow transitions and icons to create better forms and screens.
  • Form Design Best Practices: What you can and can’t do in Jira – Now that we know what good form design means, we’ll hone in on which practices can be applied to Jira and Jira Service Desk
  • Use cases – We’ll also include a series of use cases illustrating how using forms expands what you can do in Jira.
  • Form audit – Finally, we’ll take a bad form and transform it to an awesome, user-friendly, data collecting machine.

About ThinkTilt

ProForma is the forms solution for Jira, making it easy for teams to build and deploy online forms, backed by Jira’s great workflow engine. Empower every team in your organization to take control of their processes and deliver first class request management. All the information you need, where you need it.

About Rachel Wright

Rachel Wright is an entrepreneur, process engineer, and Atlassian Certified Jira Administrator.  She is the owner and founder of Industry Templates, LLC, which helps companies grow, get organized, and develop their processes.  Rachel also uses Atlassian tools in her personal life for accomplishing goals and tracking tasks.  Her first book, the “Jira Strategy Admin Workbook, was written in Confluence and progress was tracked in Jira!

Role Based Jira, Jira Service Desk, and Confluence Training Strategy

When considering your Atlassian product training strategy, select content that’s specific to each user’s role and delivered in manageable pieces. Different types of users need different information, different levels of detail, and need it delivered at different times. It’s tempting to gather everyone in a big room for a marathon training class. But it’s much smarter to offer role-specific information in small, digestible, and progressive pieces.

Progressive, Role-based Training

Intro to Jira Cloud Agenda

In the beginning, a brand new user just needs to know the basics.  Answer questions like:  “What is this application?”, “How do I use it?”, and “How do I access it?” Take a look at the agenda in our 30 minute “Intro to Jira Cloud” online course, for example. It’s short and specifically designed not to overwhelm new users. The goal is to get them feeling comfortable in the application immediately. Consider that some employees may have used Atlassian applications before. Their previous experience, version, use, and expectations could differ from what’s expected in your organization.

As part of initial training, give new users a simple homework assignment. Here’s an example: (1) to log into the application, (2) bookmark it in the browser, and (3) create a Jira issue, a Confluence page, or a Jira Service Desk request. You can test whether their creation meets the needs of the organization. This is a great time to catch problems before they turn into bad habits. Look for future trouble like missing an important issue field, creating a page in the wrong global space, or providing vague request details.

Once the user understands the basics start adding additional content. Select new content based on user role, how they’ll use the software, and skills they’ll need to do their regular job. Time the content delivery so they can learn little by little without impacting their other work.

User Types and Roles

Here are some additional user types and content recommendations:

  • The regular or occasional user needs info about sharing and organizing their data, creating filter subscriptions, linking, and logging time.
  • The power user wants information about basic & advanced search, JQL, and bulk changes.
  • Team leads, project managers, and scrum masters want to know about views like dashboards, boards, and reports.
  • Service Desk Agents want to understand service level agreements (SLAs) and how to use JSD features to support their customers.
  • Application admins want information about configuration, performance, effective workflows, best practices, mistakes, and certification.

Delivering information progressively, and based on roles, lets you quickly and effectively train users. They can put the info into practice immediately and won’t forget everything they learned by the end of the day.

Let Us Handle Your Training

We know admins don’t always have the time or expertise to train users. We do and we’re good at it. Let us deliver your company-wide training though our efficient, 30-minute, online, skill or topic-based courses.

Please complete the form, or share it with your training coordinator, so we can recommend courses, presentations, and materials.

How can we help with your training needs?

Training Your Jira, Jira Service Desk & Confluence Users

The job of an Atlassian administrator is never done. Your list of responsibilities is endless. You’re making sure your applications are up and running so work can get done. You’re weighing the benefits and long-term impacts of customization and add-on requests. You’re assisting users with access, permissions, and restrictions. You’re helping teams get the most out of the applications. And some of you are doing all of this while performing other tasks or managing other software. With all the demands on an Atlassian administrator, where does user training fall on your to do list? If you’re like most admins, it’s probably at the very bottom.

Continue reading “Training Your Jira, Jira Service Desk & Confluence Users”