Keeping It Clean: Containing Jira Custom Field Growth

You did it!  You auditeddeleted, merged and substituted and now your Jira instance only has the custom fields it should have.  Congratulations – that was hard work!  Pat yourself on the back, eat some chocolate, do whatever you do to celebrate.  Then take a deep breath and get ready to go to work again, because now that you’ve got your Jira instance nice and clean, you need to take a few steps to keep it that way.

The good news is that custom field clean-up isn’t like laundry, where you never really get it all done.  Once you’ve cleaned up your instance you can put processes in place to keep it that way.

When to Create a New Jira Custom Field

There are times when creating new custom fields is justifiable, but you want to make sure it’s really necessary before you create one.  Here are a few things to consider:

  • Is it needed?  In tech, we’re often tempted to do things just because we can. That’s not a good enough reason to create a custom field.  When users request a new field, ask them for the business case for collecting that piece of data. 
  • Does the data need to be in its own Jira field?  Will this data be queried or reported on later?  If not, could you just as easily capture it as a ProForma form field?  Or prompt users to include it in the Jira description field?

  • Would the field be used by different teams across the organization?  Jira assets should be shared whenever possible.  Making usability across multiple teams one of your criteria will help contain custom field expansion. 
  • Is there a Jira system field that you can use?  Make use of existing options. Teams can set their own protocols for what to include in a summary field versus a description field, or create a project-specific plan for how they will use the label field, etc.  Encourage users to use what’s there before asking for more.

In order to have the above information whenever a new field is requested, you’re going to want to implement a process for requesting new custom fields.  ProForma offers a template that users can use for requesting custom fields and Rachel Wright offers a new custom field request worksheet

In the Jira Strategy Admin Workbook, Rachel also recommends publishing a list of currently available custom fields.  This encourages users to look and see what’s already there before requesting something new.

Custom Fields and Next-Gen Projects

Note that these processes assume that you’re working the old-fashioned way, with traditional, classic, old school Jira projects.  If you’re using Cloud, then you may have empowered your users to create “Next-gen” projects. Next-gen projects are pretty new and it’s fair to say that the jury is still out.  The idea is that users will be empowered to create their own projects, issue types and custom fields.  These projects are self-contained and the inevitable balloon of new custom fields should not impact Jira performance. However, there’s nothing to prevent users from making errors such as misspellings and incorrect field types – errors which they may, or may not know how to clean up.

So what are our recommendations for managing custom fields in Next-gen projects?  First, the new project capabilities are configurable.  The default setting is “anyone,” but you can decide which groups to grant this power to.  Once you do decide, give these newly empowered users some training, which should include when to and when not to create a new custom field. Initially, alternatives may be more limited for Next-gen projects than for classic Jira projects.  Like many Jira apps, ProForma doesn’t yet work with Next-gen projects, but as use of Next-gen projects expands, options will too.

Will be exploring the possibilities and impact of Next-gen projects in upcoming articles.  In the meantime, enjoy hanging out in your nice clean Jira instance!

Reducing Jira Custom Fields through Substitution

One of the principle advantages of using ProForma – the app that lets you create forms that embed in Jira issues – is that it allows teams to collect customized data without needing Jira custom fields.  In the previous article in our series on reducing custom fields, we discussed how to delete, hide and merge custom fields.  In this article, we’ll explore the fourth option – substituting a form field for a Jira custom field. 

When to Use

This is the solution that provides the best of both worlds.  You get to have the data without having the custom field.  That being said, there are some limitations you need to consider before implementing this solution.

Limited Search Capability

Currently, fields on ProForma forms are not searchable in Jira.  There are two ways you can work around this.  For fields that are frequently queried and reported on, you can link a form field to a Jira field.  This allows you to collect the data in one place and still have access via JQL queries and Jira reports.  However, this doesn’t help as far as reducing fields.

The other option is to download a spreadsheet of forms responses and search there.

We are working on creating functionality which will allow you to link multiple form fields to one Jira field (for instance, the description field). This will allow teams to collect and view the information in a structured manner, while still having the data available for searching in Jira.  We anticipate releasing this functionality in early 2019.

Conversion Process

The other thing to keep in mind is that the conversion process (described below) is not for wimps!  We recognize that it’s a bit labor intensive and we are working to develop an automated process.  (For this reason, it’s highly recommended that you triage incoming requests for new custom fields and use form fields in lieu of custom fields as much as possible.)

Preparing the People

Reassure users that they will still have the data.  If users are new to ProForma, you want to show them how ProForma is used on another project in order to reduce their concerns.  You’ll encounter less resistance if users understand that they’re not losing any data.

Second, knowing that the conversion is a bit involved, you should prepare your users to be patient.  You will also want to work closely with Project Admins – letting them do some of the tasks (such as building the forms) – especially if you’re substituting fields across multiple projects.

How to Do It

1. Build a form that includes the target fields.  Each field has the option of being linked to a Jira field.  Be sure to create a field for each custom field that you wish to eliminate.  For each of these fields, use the Link Jira Field option to link the form field to the existing Jira custom field.  Note that you may want to link other fields as well.  For instance, it’s very useful to have a “What’s the problem?” field link to the Jira summary field.

  • The form can include as many fields as needed (not just the fields that are being converted).  Create forms that will be useful for the team after the conversion process is complete.
  • You may be able to get a head start by modifying a form from the ProForma template library.
  • Organize fields into logical sections.  Add instructions.  Use ProForma features such as validation, conditional logic and field-level hints/descriptions to make your forms as user-friendly and useful as possible.

2. Once the form has been built, you will need to add the form to all of the relevant issues.  Depending on your situation, this could be every issue in the project, or only those issues that have data in the custom fields you’re converting.  Currently, add ProForma forms to issues has to be done manually.

3. Next you need to go through and open each form and check that the contents are correct.  The target form fields should contain the data from the custom fields.  Save and Submit the form on each issue.  Note that the data doesn’t get locked into ProForma until the form has been submitted.

The data from the custom field is now present on both the custom field and the form.  Be sure to click Submit to lock the data in the form.

4. Now return to the form builder and open the form.  Go to each of the form fields associated with a custom field you want to eliminate and unlink the Jira field. Remember to Save.

5. The populated form field is now independent of the Jira custom field.  To verify that you have completed the process, run a JQL query for  [custom field] NOT EMPTY.  Then download a form response spreadsheet and compare the results.

6. Once you’ve confirmed that the forms contain the custom field contents, you can delete the custom field following the directions here.

We recognize that this is a labor intensive process and we are working to develop an automated process for converting fields in large projects. Please contact ThinkTilt if you would like to be notified when that functionality is released.

**Note that the process described above is for traditional Jira projects (Business, Service Desk or Software).  ProForma is not yet fully functional with Next-gen projects.

Deleting, Hiding & Merging Jira Custom Fields

Congratulations!  You’ve audited your Jira custom fields and even decided on which methods you’ll use to reduce them.  So now it’s time to get started. In this article, we’ll provide the steps for three of the options:  deleting, hiding, and merging Jira custom fields.  For each option, we’ll not only look at the steps for execution, we’ll also discuss when you should use it and how you should prepare users for the change.

Let the pruning begin!

Deleting Jira Custom Fields

When to Use

Don’t do this lightly.  Deleting fields will also delete the data they hold and this act cannot be undone.  Therefore, this method is best reserved for fields that were created, but never used (a scenario that occurs more often than one might think), or in cases where the data has been moved to another field.

Preparing the People

Users will not react kindly to having something they feel they need removed.  So check first to see if anyone is using the field.  If they are, provided a substitute (we’ll discuss how to do this in the next post) or a work-around before deleting the field.  You’re a hero when you give users functionality, but a devil when you take it away.

How to Do It

  1. Select Jira settings > Issues
  2. Under Fields, select Custom Fields
  3. Find the custom field and click the gear icon
  4. Click Delete to remove the custom field and any information entered in the field from all issues.

Hiding Jira Custom Fields

When to Use

Although this method doesn’t truly reduce the number of custom fields in your instance, it does allow you to declutter your screens.  This is a good method to use for custom fields that were used in the past and contain data that you don’t want to use, but are not (or rarely) used now.

You can also hide fields as an intermediary step before deleting them.  Hide the field, wait a week or two to see if users miss it, and if not, then delete the field.

Preparing the People

Most of the time when you use this method it will be for fields that were important in the past, but are no longer in use.  Check with the Project Admins to confirm that this is the case.

Note that if you’re told, “Oh no, we need that field!” but suspect otherwise, you can query for [custom field] NOT EMPTY and then sort by last updated date to see how frequently and how recently the field has been used.

How to Do It

To hide a Jira custom field go to Project > Project Settings > Fields.  Find the custom field and click Screens.  Click Remove.

Merging Jira Custom Fields

When to Use

In the rush to create what we need, we often forget to check if it’s already there.  Your audit may reveal that multiple custom fields have been created which essentially do the same thing.  In this case, you should select the one best option (correct field type and most generic name) and merge the other fields into it.

Preparing the People

The key in this case is communication.  You simply need to let people know that the field they formerly used (XYZ Project Start Date) has now been renamed (Start Date).  You can use an announcement banner (available on the System admin menu) to communicate with all of your users.

How to Do It

  1. Add the new (correct) field to all relevant issue type(s).
  2. Run a query to return all of the Jira issues you wish to update (all issues in which have data in the old/incorrect field).
  3. Adjust the columns to show the summary, issue key, the old/incorrect custom field, and the new/correct custom field.
  4. Click Export Excel CSV (current fields).
  5. In your CSV file, remove any unnecessary columns, and everything but the header and data rows.  (The export may add extra rows of footer/header content).  This is also a good opportunity to “clean up” your data – fix misspellings, etc.
  6. Now go to the Jira Administration menu and select Jira Settings > System.
  7. Select External System Import (under the Import and Export heading) in the left hand navigation bar.
  8. Select CSV.
  9. Click on the Choose File button and browse to your CSV file.  Click Next.
  10. Select your project.  Note that you can also add an email suffix and adjust the date format on this screen.  Click Next.
  11. Map your fields including the issue key, summary and the relevant custom fields:
    1. Issue Key (CSV field) > Issue Key (Jira field)
    2. Summary (CSV field) > Summary (Jira field)
    3. Old/incorrect custom field (CSV field) > New/correct (Jira field)
  12. Click Next.  Jira will make the update and indicate the result.
  13. You can repeat your original search to see the data from the old/incorrect field is now populating the new/correct field.
  14. Follow the instructions above for deleting the old field.

Stay Tuned

The next article in this series will describe how you can substitute a ProForma form field for a Jira custom field.  It’s the perfect solution for times when teams need the data, but don’t need to query or report on it.

Time to Decide: What to do with all those Jira Custom Fields

In a previous article, Rachel Wright outlined a process for auditing Jira custom fields.  If you’ve completed this process, you now have an idea of all of the custom fields in your Jira instance.  Finding out what you have is an important first step.  Next you need to decide what to do with them.

If you haven’t already, log your information into a spreadsheet, a Confluence page or use the free Jira Custom Field Audit worksheet.  At a minimum, you will want to collect the following information:

  • Name – The name of the Jira custom field
  • Type – Knowing the field type can be useful in determining if the field can be merged
  • Description – What the field is for
  • Created by – Was the field created by Jira, by a person or by a plugin/app?
  • Used by – Who is or has used this field?  Which Jira projects?
  • Currently in use – Is anyone using the field now?

I found all my custom fields.  Now what do I do with them?

Follow the recommendations Rachel describes, or try the SQL queries provided by Atlassian.  Once you’ve filled in the above information, you need to take the next step – engaging with Project Admins, business owners and other users to find out if and how the fields is being used, and to determine if another solution might work just as well or better.  Ask questions such as:

  • How do you use the data in this field?
  • Do you query the field? (You can verify this by checking to see if the fields is included in any filters.)
  • Do you report on the field?
  • Does anyone remember how you handled this data point before you had the custom field?

As you talk to business owners, users and project admins, it’s important to be clear that your aim is not to take needed functionality away from them. There are many ways to reduce custom fields without losing current functionality.  After you’ve completed your research and your conversations with business owners, you can recommend one of the following options for each custom field:

  • Keep it
  • Merge it with another Jira custom field
  • Substitute it with a field on ProForma form
  • Aggregate it with other data into one field
  • Retire it
  • Delete it

We’ll discuss how to do each of those things in a future article.  For now focus on deciding what the future of each of your custom fields should be.

When to Use Each Option

Keep it
Don’t change a thing.  The field is necessary just as it is.

Merge it with another Jira custom field
Your Jira instance may have accumulated multiple custom fields that are essentially the same (for instance, multiple sets of start and end dates). These can be safely merged together into one field that has a generic name.

Substitute it with a field on ProForma form
Many data points are needed in order to handle a request (service desk projects), or track information that is important, but rarely queried or reported on.  You can still collect specific, structured information without custom fields, by collecting the data on a form.

Aggregate it with other data into one field
Aggregating is another good option for data that is collected for purpose of providing a service, background info, etc., but that is only occasionally queried or reported on.  This involves collecting the data on a structured form, then storing the data from multiple form fields in one Jira field.

Hide it
You can hide custom fields that were used in the past, but are no longer necessary.  This allows you to preserve the data while decluttering your screens.

Delete it
Delete fields that are not being used and that do not contain any data that needs to be preserved.  It’s recommended that you not delete custom fields that were created by Jira (and in many cases Jira won’t let you).

Add a Recommendation column to your spreadsheet and log the selected option for each field.  You now have a plan for each of your custom fields. Watch for the next article in this series, where will discuss exactly how to apply the above options.

Battling Jira Custom Field Bloat, Step by Step

“I have over 3,000 custom fields and everyone says I need to talk to you.”

That was one of the comments we heard at Atlassian Summit.  It’s true. ProForma is a great way to have all of the custom data, without the custom fields.  ProForma forms embed in Jira issues, allowing you to include all of the fields you need, without cluttering your Jira instance or degrading Jira’s performance.

We think simplified Jira administration, particularly with regard to custom fields, is one of the key benefits of using ProForma, and something we’ve discussed in previous articles:

However, talking to Jira Administrators at Summit made us realize that we’ve neglected a big part of the problem.  You don’t just need a way to limit the addition of new custom fields, you need a way to deal with the ones you already have.  So we’ll be focusing our upcoming content on how to deal with custom field bloat.  Once again, we’ll be teaming up with author and Jira super-user, Rachel Wright.  Rachel worked with us on a previous series of articles, which is now available as the Effective Jira Administration book. We’re looking forward to tapping into her expertise on managing Jira custom fields.  

ProForma Forms & Custom Fields for Jira

Cleaning up Jira Custom Field Bloat

Regardless of whether you’re using Cloud, Server or Data Center, our series will offer step by step guidance for:

  • Auditing
    Find out exactly what custom fields you have, what project(s) they’re in and if/how they are used.
  • Triage
    The next step will be to categorize your custom fields.  You’ll sort out how the custom fields were created (by an admin, an add-on, etc.), whether or not they’re duplicates, if they contain errors, and how they are used.  We’ll outline the process for sorting your custom fields into ones that stay, ones that go, and ones that get converted. 
  • Conversion
    Next, we’ll outline a process for converting needed fields to ProForma, for merging duplicate fields, fixing errors and for retiring fields that are no longer needed.
  • Documentation
    Finally, we’ll make sure that you’re left with an easily accessible map that will show which custom fields remain and which were converted to fields on ProForma forms.  Having this information at your finger tips will make it easier to respond to requests for new custom fields. 

The goal is that by the end of the process, your teams will still be able to collect all the data they need, but you’ll have your custom fields down to a manageable number.  (You get to decide what that number is.)

Next-gen Projects

For those of you using Jira Cloud, we’ll also discuss strategies for how to manage custom fields (and Jira administration in general) now that any user can create independent projects.  (If this makes you nervous, you’re not alone.)  We’ll focus on communication strategies and ways to educate users about best practices in Jira, with the aim of being “open”, without opening up a huge can of worms for Jira administrators.

Bringing FY2018 to a Successful Resolution in Jira

Everything must come to an end.  One could say that FY2018 is about to reach its resolution.  (I’ll let you decide if want to mark it off as Fixed, Won’t Fix or simply Done.)  The end of the year is a traditional time for stock-taking as we prepare for a fresh new start.  You can apply that to your Jira application as well.

Cleaning Up Your Jira Application

Use the end of the year as an opportunity to check for and clean out stagnant Jira assets.  Sometimes projects get abandoned instead of being properly closed out.  This can happen when the organization’s priorities change or when teams reorganize.  Sometimes an initiative that was tracked in Jira is completed and teams who are anxious to carry the momentum into the next project may forget to close out the previous one.

In the Jira Strategy Admin Workbook, Rachel Wright offers several ways to hunt down stagnant Jira projects.  You can use the Project Status worksheet, available in the ProForma template library, to comb through your projects and identify ones which should be archived. 

While you’re doing the high level assessment and clean up, you can encourage Project Leads to take a look at their active projects and see if any clean up needs to be done there. Rachel recommends checking for things such as:

  • Accurate and useful components (and component Leads)
  • Unreleased versions
  • Stagnant issues (haven’t been updated in x days)
  • Unassigned issues
  • A neglected backlog
  • An accurate listing of team members

This is also an opportunity to see if any adjustments (big or small) should be made to make the system more helpful.  Are the filters, boards and dashboards useful?  Could they be more useful if you made a few minor changes?  Does the project configuration still fit the team’s needs?  Are there any customizations that the team would like to have?  Any painful processes that could be eased with the addition of the right app/plugin? Now is a good time to take a look.

What You and Jira Accomplished this Year

Year end is also an opportunity to compile and analyze a few statistics on how Jira is used within your organization.  In fact, regular and thorough documentation will not only demonstrate how important Jira (and therefore the Jira support team) is to your organization, it will help you predict future needs. In addition to an Annual Report form,  Rachel has also created a Jira Use and Future Predictions worksheet which will help you document Jira usage over time.

Expanding Jira to Business Teams

While you’re making those predictions, consider whether Jira could benefit more teams in your organization.  Many companies use Jira or Jira Service Desk not only for software or IT support, but also to manage HR, finance and facilities related processes.

Expanding Jira to other business teams doesn’t have to be an administrative nightmare.  The simple addition of forms, available through the ProForma app, means that teams can customize their processes and collect exactly the data they need without requiring new issue types, hordes of custom fields, or special configurations.  You can actually simplify Jira administration even as you’re bringing more teams into Jira.

Jira Clean-up Time: How to Audit and Tidy Your Jira Instance

Depending on where you are in the world, you may be smack in the middle of spring – as in time for Spring Cleaning.  Even if it isn’t spring, it’s a good idea to occasionally audit your Jira installation, archive elements that aren’t being used and revisit your configuration to ensure that it’s optimized. Below are the basic steps you will need to perform a “Jira Clean-up.”

Jira Clean-up Step 1: Audit

The first step is taking stock of what you have.  To do this, start with the “System info” page and note the number of projects, issues, custom fields, workflows, etc.  Next, visit the Add-ons admin page and the admin area for each scheme and project asset.

Jira System Stats

Rachel Wright offers a worksheet for recording this information.  Alternatively, you could use a spreadsheet or create a form in ProForma. The important thing is that you will want to track the number of Jira assets over time. 

As you go through the admin pages, note assets that are unused (such as a field that doesn’t appear on any screens), duplicated (or perhaps similar enough in purpose that only one field is needed) or inactive.

Once you have a complete picture of your current application, you can set goals for your clean-up.  Along with removing assets that aren’t being used, goals could include reducing the number of workflows for easier support and reducing the number of custom fields for better performance.

Jira Clean-up Step 2: Archive

Before you begin pruning out unnecessary elements, backup and verify your data.  Also, make sure you have a rollback plan in case any of your changes cause unanticipated problems.

Elements

Go to the admin page for each element type and use the “identification” column to weed out unused items.  The Jira Strategy Admin Workbook includes detailed instructions for easily identifying unused elements.  In some cases (for example, if you are eliminating an issue type), you may need to migrate issues before deleting.

Deleting unused items is the first step.  Depending on your goals, you may also want to consolidate custom fields or workflows.  When consolidating fields, consider which field is more widely used, which has a better name, and which can be more easily deleted.  Again, you may need to migrate data before you can delete.

Projects

Jira Project Status in ProForma

Along with pruning down Jira elements, you should also check for stagnant projects.  Use the Jira Strategy Admin worksheet or the ProForma form to identify projects that have an inactive project lead, few issues or no recently created issues.

You have several options for dispatching completed or stagnant projects:

  • Prevent new issues from being created
  • Mark the projects as read only
  • Hide the project
  • Archive the project
  • Export the project

Rachel Wright describes the appropriate use, as well as the implementation steps, for each method in the Jira Strategy Admin Workbook.

Users

Finally, you need to address users who have left the organization.  Don’t users because you want to retain the history of their actions.  Rather, set departed users to “inactive.”  However, before doing so, Rachel recommends the following steps:

  • Move any not closed, assigned issues to the user’s supervisor
  • Move any not closed, reported issues to the user’s supervisor
  • Remove unshared custom dashboards, filters, filter subscriptions and boards
  • Remove favorite designations for dashboards
  • If a dashboard is used by others, move the dashboard to the supervisor or a generic user account
  • Remove favorite designations for filters
  • Move shared filters to the supervisor or a generic user account
  • Reassign project leads to the supervisor
  • Reassign component leads to the supervisor
  • Remove filter subscriptions
  • Remove draft workflows
  • Reassign agile boards to the supervisor
  • Check workflows for any auto assignment transition behaviors
  • Make the user account inactive

Making the time to regularly review and tidy up your application will make your ongoing admin duties easier and will keep your application clean, relevant and high-performing. 

Tips for Vetting Jira Apps and Plugins

Do you get sensory overload when you visit the Atlassian Marketplace?  The current plugin count shows over 1,600 offerings for Jira alone.  Too many choices can be paralyzing.  How can you identify which apps will be truly useful and worth the effort of maintaining?  What is the best strategy for vetting Jira apps?

A Process for Requesting Jira Apps & Plugins

Start by setting up a process by which teams can request an app.  At the very least teams need to provide the name of the app and the Marketplace URL.  Getting more information, like what the app does, why the team thinks they need it, and examples of how they will use it will give you a solid basis for making a decision. 

After you’ve had a chance to check the price and ensure that the app is compatible with the your Jira application, you’ll also want to confirm that leadership has approved the app and is willing to pay for it.  Also, check that the security team is on board with adding the plugin.

Hmm… you need a process for placing requests with specific pieces of information from the requestor; a way for an agent to add more information to that request; and a mechanism for recording management approval – sounds like a job for ProForma and Jira Service Desk!

What to Ask When Vetting Jira Apps & Plugins

Questions to consider when deciding whether or not to install a Jira app might include:

  • Does the app/plugin duplicate functionality that is already available, but underutilized in Jira?
  • How much will the app/plugin be used?  How frequently?  By how many users?  How many teams?  In how many projects?
  • Does the app/plugin allow you to leverage Jira, making Jira relevant and useful for more teams?
  • Does it come from a trusted source?
  • Is the app/plugin a good value compared to other solutions for resolving the problem?
  • Does the app/plugin provider offer adequate support?

Teams requesting new apps are doing so because they believe the app will resolve a specific problem or pain point.  New apps, however, also impact the Jira Administrator and Jira Support Team.  Every app will add another layer to manage.  However, some apps may actually relieve some of the Jira Administrators pain points as well (too many custom fields, too many custom workflows, etc.)  An app is of greater value if it’s useful for both teams (and different types of teams) and Jira support staff.

App Vetting Request in ProForma

App Vetting Tracking in ProForma

Best Practices for Installing Apps

Having developed a process for vetting Jira apps, next you will want to test the new apps before deploying them into production. In her excellent resource, the Jira Strategy Admin Workbook, Rachel Wright outlines a clear procedure for testing new apps.  She also provides a packet of worksheets which can be used for vetting, installing and announcing new Jira apps.

Jira Plugin and Add-on Vetting Procedure

Jira Plugin and Add-on Announcement

Something to Consider

While you’re looking at Jira apps, we hope you’ll check out ProForma Custom Forms & Fields for Jira.  ProForma makes it easy to create forms that embed in Jira issues, allowing you to add all of the process-specific fields you need.  Since every field added to a form is a field you don’t need to add to the issue, ProForma can greatly reduce the need for custom fields. Forms are also the key to leveraging Jira’s flexibility to serve more teams.  HR can create forms to track the data they need in Jira and Marketing can create forms to track the data they need.  You’ll be making Jira admin easier even as you bring more teams into Jira.

Too Much of a Good Thing: Alternatives to Jira Custom Fields

Customizing Jira for Business Teams

Jira is a great tool for business teams because it’s so easy to customize.  After all, the information a software team needs to track will be different from the information an HR team needs to track.  You can create custom fields to collect information that doesn’t fit in standard Jira fields, but be careful lest you fall into a murky swamp of slow performance and more custom fields than you care to manage.  In fact, Atlassian has identified the number of custom fields as the attribute which has the highest impact on the speed of the most common Jira actions.

Related:  Watch Atlassian’s Five Secrets of JIRA Performance at Scale

Wondering if you’ve got too many custom fields already?  According to Rachel Wright, author of the Jira Strategy Admin Workbook, load time of your screens and your custom field admin page are good indicators.  Also, note how long your custom field admin page scrolls.

What should you do if you’re committed to limiting the number of custom fields, but still want to take advantage Jira’s flexibility?  Who should decide when a new custom field is justified?  And what should the criteria be for that decision?

Start by putting a process in place that project leads can use for requesting a new custom field.  Use the ProForma process template or the Strategy for Jira worksheet to gather information such as the proposed field’s purpose, type, screen schema and any needed validation rules.

Then consider the following questions:

  • Will the new field be used by multiple projects?
  • Will you query issues based on this field?
  • Will you run a report of all the values in this field?
  • Will the field duplicate an existing field?  (Rachel recommends publishing a list of existing custom fields and their uses to encourage users to make the most of what’s already there rather than requesting new fields.)
  • Will it duplicate core Jira functionality?

If you determine that a new custom field is indeed needed, pay special attention to creating it with the correct field type, as this cannot be changed later.  Having the requestor provide examples of the data the field will hold will help ensure that you select the correct field type.  (Or maybe you can suggest a better way to track the info altogether!)  Give the new field a generic name so that it can be used by more than one project.

Alternatives to Jira Custom Fields

Saying “no” to creating a new custom field, doesn’t mean you have to say no to giving users what they need.  You have a couple of other options for collecting the same data:

  • Use a standard field for a custom purpose
    Standard Jira fields can be manipulated to collect different data for different projects. For example, the Jira field “Labels” can be used in different ways by different teams.  A marketing team using Jira to track their production of marketing assets could use the Labels field to record the marketing campaign an asset is associated with.  The same field might be used in a different project, by the facilities team, to record locations.  You can use a field configuration to set a project-specific description of what should be recorded in the field, thereby prompting users to put in the right information.
  • Adapt an already existing custom field
    One custom field with two contexts

    Field contexts can be used to make an existing custom field serve different functions in different projects.  Field contexts allow you to set a default value and a defined options list for the field within a given project and with a given issue type.  For instance, you could create a custom field called “category”.  The HR team might use this field to store employment status and might have four options (full time, part time, intern, contractor) to select from, with “full time” set as the default value.  The finance team could use the same field in their project, but the options could be set to record different payment methods (EFT, check, purchase order, etc.)

  • Use a ProForma form
    Another option is to collect the information on a form.  Forms are an easy way for business teams to collect exactly the information they need without requiring changes and customizations to your Jira configuration.  Teams can design, build and deploy forms that gather data structured to their needs and validated with their business rules.  Many of the data points required to fulfill a request don’t need to be queried or reported on.  For those that do, the ProForma form builder makes it easy to “pipe” information from a form field to a Jira field.
Piping For Data Jira Fields in ProForma

Finding the balance that allows you to maximize Jira’s flexibility without sacrificing performance is a key consideration when expanding Jira to business teams.  ProForma can help.

Who’s in Charge? Jira Governance for Business Teams

Getting off to the right start is always the best way to go.  It’s not always reality.  We usually inherit things – business processes, Jira applications, our parents’ bad habits, etc.  In her excellent resource, the Jira Strategy Admin Workbook, Rachel Wright recommends starting out by creating a Jira Advisory Board.  If you’re starting from scratch, this is a great first step.  If you’re already using Jira, now might be the time to put your Board in place, especially if you’re considering expanding Jira to other teams in your organization.

Different organizations have different ways of governing their processes. Rachel recommends that the role of the Advisory Board include:

  • Deciding what customizations to create and support in order to strike a balance between giving teams what they need and maintaining a manageable, high-performing application.
  • Setting standards for privacy, security, and storage and handling sensitive information.
  • Developing a process for providing support for teams’ Jira projects.
  • Determining what a successful Jira application looks like.  What metrics will define success?

Who Should be on the Advisory Board?

When you consider how powerful and mission critical Jira can be for your organization, it’s clear that it shouldn’t be directed by just one person.  But who else should be on your Board?  Rachel recommends a group of about five people including:

  • An end user – techy-minded or not
  • A Jira Administrator who understands the application’s capabilities
  • A Project Manager, Business Analyst or Strategist – basically a process-oriented person
  • A high level manager or VP who’s ultimately responsible for the work that gets done in Jira
  • A wildcard member to keep everyone on task

Consider having your end user or your wildcard member come from a non-technical business team.

Why Create a Jira Advisory Board Now?

You’re probably thinking, we’ve managed this long without a Board, why do we need one now?  If that’s the case, one of two things is probably happening.  Either your Jira Administrator is handling everything on their own, trying to please everybody, and relying on their own knowledge for deciding what should and shouldn’t be implemented.  Or you do have a group of people who work together to set standards and support Jira users – you just don’t think of them as an Advisory Board.

If you don’t already have one, the moment of expanding Jira to business teams is an excellent time to establish a Board.  Here’s why you need one now, even if you didn’t think you needed one before:

  • Expanding Jira to business teams will mean more requests for customizations; more custom fields, more screen schemes, more configurations.  With each request, you will need to decide if it’s worth creating and supporting the new asset or whether an existing field, scheme or configuration can be shared.  You’ll come to better decisions if you include multiple points of view.
  • You’ll also be collecting more sensitive information.  Consider all the personal information HR keeps on employees.  You need a policy to determine what kinds of sensitive information can be stored in Jira. Expanding to business teams also means you’re inheriting all of the privacy and security standards that apply to those teams.  Again, you don’t want to be deciding how to navigate that alone.
  • Finally, teams may be skeptical as to how well a solution developed for IT can address their needs.  That’s understandable.  We’re all experts in our own areas.  Having an Advisory Board that includes non-techies will help people feel more assured that their needs will be considered.

Easily Convert Business Teams to Jira

Expanding Jira to business teams is a great opportunity to bring a tool you already know, love and support to wider use in your organization.  Teams from Finance to HR will love handling their requests in Jira, being able to measure and predict their workload using Jira’s reporting and knowing that their backsides are covered with Jira’s end to end traceability.

Along with making sure business teams’ conversion to Jira is done right (the reason you’re setting up that Advisory Board), it would also be nice to have it done easily.  This is where ProForma Forms & Templates for Jira can help.  ProForma offers a template library and an easy to use form builder that puts teams in control of collecting exactly the information they require, without the need for custom fields, screens and configurations.  You may actually find yourself doing less Jira admin even as you bring more teams into Jira.

You can help your business teams have it all:  a great tool, a well-governed application and an easy conversion.