Best practices: key factor to a successful JIRA implementation - Valiantys - Atlassian Platinum Partner

Best practices: key factor to a successful JIRA implementation

The relatively recent arrival of Atlassian tools means they are often installed and used in isolation from established mainstream IT. Fair enough. But as the popularity (JIRA, Confluence, etc.) grows from their ease-of-use and flexibility they are soon found delivering business critical services. Victims of their own success, the inevitable happens. For better or for worse, they end up being plumbed in to the mainstream IS.  Its at this point we should stand back and consider our approach…

Let’s take a typical case of a JIRA instance that has evolved and grown in line with changing needs.  More often than not, its configuration has become complicated, its performances may be falling short of the mark, and to top it all, no one really knows how to best administer it. To reconfigure it – and ensure it will function well in the future – a governance policy is needed, coupled with a good dose of best practices for its implementation.  So, here’s a couple  examples to ponder:

Precise classification of objects

When we work at clients’ and we want to add or modify configuration elements, we very often discover administration pages full of randomly named systems :

Issue type screen schemes

One can hardly guess the role of the 5 systems presented above based on the name of the objects.

Consequently, we need to research who this system is for and what purpose it serves. The easy option is to create a new system that answers our needs and that we are 100% sure about, even if this implies creating a duplicate.

However, too much of this behaviour risks your JIRA instance quickly becoming overloaded, less easy to use, and difficult to maintain.

To correct this, we will have to impose one classification for each element we will use. Thanks to this classification, you will be able to spot at a glance the purpose of a configuration object, its positioning among all levels of objects offered by JIRA, and, to know the impacts of a potential modification.


When you apply the following pattern to screen names:

<ProjectCategory>_<ObjectType>_<UsageType>_<OperationNameOrTransitionName>_<IssueType>_<Version>, differentiating screens becomes easier. This seems tedious at the beginning, but you will gain some precious time on the long run.

Add-ons: a word of caution

The second most common mistake on JIRA instances is the use of random add-ons. Take care in your choice.

The audits we lead at our clients’ more often than not show up a collection mysterious add-ons installed. Few can recall what they are for, and even fewer why they were installed in the first place.

With our Sherlock Holmes hats on, we end-up enquiring on the Marketplace and/or Google to track down the mysterious add-on and to understand what it is supposed to do. More often than note, the outcome is that the add-on is not really used and can bed de-installed or replaced with some configuration with now impact for users.

Abandoning an “unknown” add-on helps lighten the load on the instance, simplifies its configuration and can bring a performance gain. Remember! Some add-ons, especially reporting ones, are very demanding in server resource.

To avoid making this kind of mistake again, we should ask ourselves the following questions while installing an add-on: 

  • Is this add-on available on Atlassian Marketplace?
  • Does this add-on answer my need?
  • Will this add-on be used in other contexts?
  • Is my need important enough to install a new add-on?
  • Is the editor well-known?
  • Does the add-on have a relevant documentation?
  • Does this add-on have support tool?
  • Does this add-on have a good release rhythm?
  • Does the editor release a compatible version of the add-on within a month after a major JIRA release?

If all the answers are YES, then go ahead. Install it. If not, you might want to reconsider.


By implementing these two best practices, your JIRA instance management can improve.

To go further and learn some more best practices, Valiantys offers the JIRA Administration training.

Made for future JIRA admins, this 2-days training will help you develop a good pattern for daily JIRA administration thanks to the introduction to concepts and the configuration exercises. Plus, by the end of the course you should be able to reorganise your JIRA instance.

Its fair to say, administering a JIRA instance is not child’s play. But good JIRA Admin training does ensures you develop the skills and competencies essential to having an efficient instance.

Interested? Check out our training dates in London. 

And if you’re interest lies in Confluence than in JIRA, we also offer a range of Confluence trainings. 

Cutted Triangle

Subscribe to the Valiantys Newsletter

Registered request ! Subscribing... This is not an email An error occured

In accordance with our privacy policy, we are committed to respecting your personal data.

Contact us

Our Atlassian certified consultants will be happy to answer you.

Join us

We're building the next dream team - Are you in?

Follow us

We use cookies for the operation of our website. This is to improve its use, to personalize your experience, and to compile visitor statistics. By continuing to use this site, you consent to this policy. You can manage the settings and choose whether or not to accept certain cookies whilst browsing. For more information, see our privacy policy. Our privacy policy

Privacy settings

In order to facilitate your navigation and to provide you with the best possible service, we use cookies to improve the site to the needs of our visitors, particularly according to the number of visitors. For more information, please read our privacy policy. Our privacy policy


Google reCAPTCHA is a system designed to distinguish humans from computers, so that bots are unable to maliciously fill out forms on behalf of a human being.


Used to send data to Google Analytics about the visitor's device and behavior. Tracks the visitor across devices and marketing channels. Used by the social sharing platform AddThis to store the user's usage history of the AddThis sharing widget. Registers a unique ID that is used to generate statistical data on how the visitor uses the website.


Targeting Cookies: Targeting cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant advertising on other sites. They are based on uniquely identifying your browser and internet device. You can turn off the use of cookies for targeted advertising here. When the button is green, targeted cookies are on. When the button is red, targeting cookies have been turned off.

Social Media Cookies: These cookies are set by a range of social media services that we have added to the site to enable you to share our content with your friends and networks. They are capable of tracking your browser across other sites and building up a profile of your interests. This may impact the content and messages you see on other websites you visit. If you do not allow these cookies you may not be able to use or see these sharing tools.