Menu

How to use Jira Software & Confluence together

Your Scrum or Kanban board is set up, complete with Epics, User Stories, Tasks, and Bugs for the sprint. There’s no doubt about it: Jira Software is a valuable tool for your engineering team. However, Jira alone might not be the best at documenting decisions, sharing wireframes or mock-ups, or summarizing progress for colleagues who do not use Jira daily.

By using Confluence alongside Jira Software throughout the entire software development process, you can build an internal knowledge base that sets your team up for success. Get inspired by the following suggestions on how to use Jira Software and Confluence together to achieve a shared understanding, and support the successful release of your software.

Enhancing agile development with Jira and Confluence integration

Jira Software excels at tracking distinct tasks for upcoming releases, but it falls short in creating a comprehensive shared history and knowledge base. That’s where Confluence performs: it organizes and shares ideas, content, and files critical for your project. If your project resources are scattered across Word documents, Drive, SharePoint, or other platforms, your team is likely wasting time locating necessary materials. By synchronizing Jira and Confluence, you can streamline this process, ensuring all project information is centrally located and easily accessible. This integration not only saves time but also enhances project efficiency.

4 ways to build tribal knowledge for agile software teams

Building tribal knowledge: 4 key strategies for agile software teams:

1. Structured knowledge organization

  • Hierarchical page organization: Establish a clear hierarchy of pages for each team or project within Confluence and link this space directly to your Jira project. This setup enhances accessibility, allowing team members to access relevant pages directly from Jira, which optimizes navigation and efficiency.

2. Transparent project updates

  • Project update pages: Develop a dedicated page in Confluence using Jira macros to display real-time issue statuses. This approach ensures that even stakeholders who do not use Jira regularly can stay updated on project progress, enhancing decision-making and project transparency.

3. Streamlined sprint processes

  • Sprint planning and retrospective templates: Leverage Confluence templates for sprint planning and retrospectives to document necessary actions and reflect on completed sprints. This structured documentation aids in maintaining clarity and focus throughout the sprint cycle, promoting continuous improvement and alignment with agile methodologies.

4. Integrated documentation and tracking

  • Linking documentation to issues: Integrate your documentation effectively by linking Confluence pages to Jira issues, enhancing team productivity by keeping all related information accessible within the Atlassian ecosystem. This seamless integration ensures that team members can access relevant documentation, roadmaps, or issue data directly from Confluence, facilitating a more organized and efficient workflow.

Simplified cloud integration

  • Automatic app links on Cloud: For teams utilizing cloud-based platforms, integrating Jira and Confluence is straightforward with automatic app linking. Simply connect your Jira project with your Confluence space to seamlessly view, create, and modify project-related documentation directly from Jira.

By adopting these strategies, agile software teams can significantly boost their productivity and collaboration. Integrating Jira and Confluence not only simplifies project management but also strengthens the foundation of knowledge sharing and operational transparency essential for agile success.

Boost your agile team’s productivity with Elements Publish—streamline project management and enhance collaboration by integrating Jira and Confluence effortlessly.

Important points to remember:

Pages must be included under Pages in Confluence to be accessible from Jira.

While Jira displays Pages, it does not show Blogs.

Centralizing all project-related documents and content in Confluence optimizes your knowledge management. Future team members and non-Jira using colleagues will thank you, we promise.

Jira Software and Confluence for Product Management

Integrating Confluence with Jira Software brings vast opportunities for Product Managers and enhances the success of software releases.

Jira and Confluence for effective requirements management

Utilize Jira and Confluence as your agile toolkit for ongoing requirements management throughout your product development lifecycle.

Confluence comes equipped with a dedicated blueprint or template for requirements management, allowing you to hit the ground running. This setup enables you to easily gather, share, and iterate on feedback. Stakeholders can engage directly by commenting on the text, the page, or making edits themselves—with all changes trackable via the page history.

Requirements management Confluence template

As the requirements are detailed, you can start creating User Stories for them in Jira directly from Confluence by highlighting the text.

Incorporating wireframes, mockups, or prototypes into a Confluence page is streamlined with various apps, centralizing all your work in one place. Team members can comment on these visuals just as they would on text or other images.

Confluence enhances visibility by automatically generating a summary page from your requirements management blueprints. This feature provides a quick overview of the status across all your projects, making it easier to track progress and updates.

Discuss, debate build consensus with DACI

Have you ever puzzled over a decision made months ago by people no longer on your project? The DACI framework offers a structured approach to document decision-making processes effectively.

The DACI (Driver, Approver, Contributors, Informed) template in Confluence is specifically designed to consolidate all essential information for discussing and debating pending decisions. This template facilitates:

  • Documenting inputs: Clearly outlines all the information required to address the decision at hand.
  • Evaluating options: Lists the advantages and disadvantages, alongside the potential impact of each proposed solution.

By using the DACI template, you not only build consensus for the selected solution but also preserve this knowledge for future reference. For instance, when deciding on the best approach to develop a new feature or resolve a bug, you can create a dedicated page in Confluence. Import the relevant details from the Jira issue using Elements Publish recipe, then begin detailing each potential option, ensuring all decision-making is transparent and accessible.

Check out the Atlassian play for tips on how to use the DACI framework with your colleagues. Once you’ve come to a decision, don’t forget to update the status so that anyone looking at the decision log with the list of DACI pages will know at a glance if a decision has been taken.

A slight alternative is the RACI, or Responsible, Accountable, Consulted, and Informed.

  • Responsible is those who will complete the work.
  • Accountable is the final approver of the work.
  • Consulted and Informed are the same.

Managing Jira Software release notes in Confluence

Jira Software allows for project organization using versions, which introduces the capability to automatically generate release notes. These notes compile all issues within a version into a categorized list by issue types.

To publish release notes, you have two options: directly from Jira or through Confluence.

In Jira Software, navigate to ‘Releases’ in the left-hand panel. For detailed instructions on generating a release note, refer to the relevant Atlassian documentation.

Creating release notes in Jira Software

You can then copy all the changes associated with your release and paste them into a document you’re creating in Confluence.

From Confluence, click on create and then from the Templates in the side navigation menu select “Jira report”. When you click “Use” select “Change log”.

Jira report template change log

Then you’ll need to select the project and version. Confluence will automatically fetch all the issues and create your release note.

Tracking release notes from Jira Software in Confluence

⚠️ You are launching a new page under the currently open parent page to provide the latest updates. To avoid having to move the page after creating it, make sure you open the right parent page before creating a new page and using the Jira Report template.

Incident management: post-mortems with Jira and Confluence

You’ve pushed a change to production, and it didn’t go as planned. To refine your change management process, gathering everyone for a thorough analysis is essential. Atlassian’s Confluence offers numerous templates to compile all necessary information for continuous improvement and even includes a guide for conducting these meetings.

However, creating a post-mortem document in Confluence can be labor-intensive, as it often involves manually transferring bug details from Jira Software. To simplify this process, the app Elements Publish automates the transfer of information from your Jira Software issue directly into a new post-mortem page in Confluence.

Incident management post-mortems with Jira and Confluence

With everything prebuilt, your dev team can focus on the root cause analysis, not copying and pasting.

Driving Success in Software Development Teams:

Using Jira Software and Confluence together throughout your software development process builds essential tribal knowledge for team success. Whether enhancing sprint retrospectives, managing product requirements, or streamlining incident management, integrating Confluence with Jira Software ensures that all decisions are well-documented and accessible, even to stakeholders not using Jira. To start leveraging both tools effectively, explore our guide on 8 ways to integrate Jira and Confluence or try the Elements Publish app for seamless documentation management.

Is your company transitioning to agile methodologies? “Jira and Confluence integration is now a strategic move for businesses exploring the Atlassian ecosystem. Jira excels in software development, IT Service Management (ITSM), and has recently expanded into business task tracking. Concurrently, Confluence serves as an ideal content management system for corporate intranets, product documentation, and customer knowledge bases. If you’ve been inspired by our explanation of why you should use Jira and Confluence together but don’t currently have the tools integrated, read on.

Why set up a Jira and Confluence integration?

Integrating Jira and Confluence can revolutionize the way teams collaborate, reducing silos of information and processes. By linking these powerful tools, you enhance team productivity and leverage their full capabilities seamlessly. With this integration, teams can effortlessly publish Jira issues to Confluence pages, integrate their Jira roadmaps into Confluence, or even create Jira issues directly from Confluence.

Discover more benefits in our detailed guide on 8 effective ways to utilize Jira and Confluence together.

If your organization already utilizes both Jira and Confluence but hasn’t integrated them, doing so can streamline workflows and significantly reduce the need to toggle between systems, thus minimizing user frustration and optimizing time management.

How to integrate Jira with Confluence?

The process to follow depends on the hosting you are using: Cloud or On-Premise versions Server or Data Center. (BTW, if you aren’t sure if you are on Cloud or Server/Data Center, look at your url or the bottom of your page as explained in this Community article).

Differences between a Jira and Confluence integration in Cloud versus Server/Data Center

What are the main differences?

  • If you are on Cloud and have added Jira and Confluence to the same site, the integration is done automatically
  • If you are on Server or Data Center, you have to configure the integration manually.

Configuring Jira and Confluence to work together on these platforms involves specific steps to ensure seamless collaboration and functionality between the two systems.

As explained in Atlassian’s documentation, the integration can be done with the bundled app Application Links that allows you to connect Atlassian products to each other. Here are the 4 steps, starting from Confluence.

1. Go to your general configuration and with a quick search, you can choose Application Links.

2. Enter the URL of the Atlassian product you want to link (in this example, Jira).

3. Follow the different steps inside the wizard to configure the link.

4. You will be redirected from Confluence over to Jira to confirm the app link in the other direction (and then sent back to Confluence to finish the process).

[vc_row][vc_column][vc_column_text css=”.vc_custom_1622193388776{border-top-width: 2px !important;border-right-width: 2px !important;border-bottom-width: 2px !important;border-left-width: 2px !important;padding-top: 20px !important;padding-right: 40px !important;padding-bottom: 20px !important;padding-left: 40px !important;background-color: #f5f5f5 !important;border-left-color: #f5f5f5 !important;border-right-color: #f5f5f5 !important;border-top-color: #f5f5f5 !important;border-bottom-color: #f5f5f5 !important;}”]

⚠️  When you are configuring the Application Link you will have a choice between the option “The servers have the same set of users” which will use an OAuth authentication, or the option “I am an administrator on both instances” which creates a one-way link. When you use a one-way link, you will be in a read-only operating mode.

If you run into any problems, check out the troubleshooting guide provided by Atlassian.

[/vc_column_text][/vc_column][/vc_row]

Jira and Confluence integration in Cloud

Working with Jira and Confluence Cloud is straightforward. When both tools are used on the same site, integration is automatic upon activation of both products. This seamless setup ensures that you can start leveraging the combined capabilities of Jira and Confluence without any additional configuration.

If you are using Jira Software, you can quickly connect your Jira project with a Confluence space or page using the feature “Project Pages“:

If you need to link Jira and Confluence instances that are hosted on different Cloud sites, you will need to configure an app link.

Remote App Links on Jira Cloud

To set up your link between different Cloud sites, find Application Links through the administration panel (try the shortcut “GG” to pull up an administration panel you can search from).

From this point, copy/paste the url of the site and product you want to link:

If you are not the admin of the remote Cloud instance, a popup window will open in which you will have several options to configure this new link:

Otherwise, you’ll just be directed to the remote instance to confirm the link, then returned to your original instance. That’s it, you just integrated remote Jira and Confluence Cloud instances.

Your team can easily use the new Jira and Confluence integration: the remote Jira is accessible for example in the Confluence Jira chart with only a few clicks.

Maximize the benefits of your Jira and Confluence integration

Integrating Jira and Confluence sets the stage for more streamlined project management and boosts team productivity. This synergy ensures that the right information is accessible in the appropriate context, processes are optimized for efficiency, and potentially, your delivery timelines are accelerated.

Ready to practice? Try publishing your Jira Roadmap to Confluence, creating issues directly from Confluence, or even publishing issue data to a Confluence page. Learn more in our article 8 ways to use Jira and Confluence together.

Trello, Bitbucket, Opsgenie: you’re probably familiar with tools from the Atlassian suite, but today we’ll take a deeper look at the using Jira and Confluence together. Confluence is great for working on content, and Jira is built for task tracking, but together they provide even more help to your team. If your team is only working with Jira or just with Confluence, you might wonder how you can use them together. We’ll take a closer look at 8 ways you can use Jira and Confluence together and bring out the best in the tools and your team.

Using Jira and Confluence together

Integrate tools to centralize organizational data, avoiding scattered files and emails. Jira and Confluence streamline management for various content types.This integration is supported by a variety of templates that make setup quick and easy, enhancing both Confluence and Jira practices.

Benefits of using Jira and Confluence together

  1. Enhanced Cross-Team Communication: Linking Jira to Confluence ensures that technical details housed in Jira are readily accessible to teams operating within Confluence. This connectivity not only simplifies access but also fosters collaboration across technical and non-technical groups. According to Atlassian, “66% of Jira software customers who use confluence said that it helped them to boost communication between development and non-technical teams.”
  2. Increased Speed of Delivery: By replacing other documentation tools like SharePoint or Google Docs with Confluence, teams using Jira can accelerate project execution. Seamless access to necessary documentation within Confluence allows software development teams to operate more efficiently. According to Atlassian, “76% of Jira Software customers said they shipped projects faster after adding Confluence.”
  3. Improved Reporting for Business Teams: Jira’s robust reporting capabilities are well-utilized by developers and project managers who track progress with tools like sprint burn-down charts and status pie charts. By integrating these reporting features into Confluence, business teams gain easier access to critical data without needing to navigate complex interfaces, thus making strategic information more accessible and actionable.

Streamline your project management by connecting Jira and Confluence. Try our Elements Publish app and experience seamless integration.

How to use confluence and Jira together

Here are eight practical ways to integrate Confluence and Jira to enhance team collaboration. These examples will demonstrate how using these tools in tandem can streamline communication, accelerate project delivery, and strengthen team unity.

Example 1: Displaying Jira issues on a Confluence page

Confluence enables you to showcase details from Jira issues. You have the option to display individual issues, an issue count (based on a filter), or a table (also based on a filter). When you opt to display Jira issues in a table format on Confluence, you can tailor the display settings and select the specific data you wish to view and its arrangement, including the issue key, summary, due date, assignee, etc. By integrating Jira issues individually or via a filter onto a Confluence page, tasks are visible alongside related notes or project documentation. No jumping back and forth between tools!

Display individual Jira issues in Confluence
Individual issues on a Confluence page
Display Jira filter on Confluence page
Multiple issues displayed on Confluence using Jira filters

Example 2: Create reports with Jira Charts

Enhance your retrospective pages or end-of-quarter reports by incorporating Jira Charts into your Confluence pages. This visual integration allows for impactful presentations and comprehensive data analysis.

Create reports with Jira Charts

Jira Charts will assist you in emphasizing essential data from Jira and sharing your findings within context by embedding them alongside explanations, useful macros, and supporting images or illustrations.

Example 3: Publish your Jira Roadmap to Confluence

Showcase your Jira roadmap on Confluence to provide all departments with access, allowing them to visualize team progress and enhance transparency regarding your product roadmap.

Publish your Jira Roadmap to Confluence

Embed your roadmap in Confluence for a comprehensive view while adding notes, wireframes, or other essential team information.

Discover how to maximize the use of Jira and Confluence with Elements Publish.

Example 4: Add a shortcut to a Jira project on Confluence

Integrate a direct link from a Confluence space to one or more Jira projects to facilitate quicker navigation. This Jira Confluence integration allows users to access the relevant Jira project directly from the Confluence space they are using, reducing the number of clicks required.

Add a shortcut to a Jira project on Confluence

If your Jira instance hosts dozens or hundreds of projects, this shortcut will be highly valued by your users.

Example 5: Create issues directly from Confluence

Enhance your workflow with the ability to create Jira issues directly within Confluence. Highlight, select the issue type, and choose the project to create it.

This seamless Jira Confluence integration is ideal for those collaborating on Confluence pages that list tasks, product requirements, or bugs, allowing for swift conversion into Jira tasks. This feature streamlines processes, making it a best practice in Confluence integrations.

Example 6: Add links to Confluence pages from an issue

As your use of Confluence expands, navigating the increasing number of spaces and pages can become challenging for team members.

Add links to Confluence pages from an issue

By implementing a direct link from a Jira issue to a related Confluence page, you facilitate easy access to additional information, reference materials, or relevant documents for anyone working on the issue. This Jira and Confluence integration ensures that team members can contribute effectively to the correct documents, enhancing productivity and ensuring continuity across platforms.

Example 7: Access Confluence project pages directly from Jira Software

When working within Jira Software, accessing relevant Confluence pages doesn’t require switching platforms. You can explore existing project pages directly from your Jira Software project thanks to the seamless Jira Confluence integration. Additionally, when you link your Jira Software project to a Confluence workspace, you can easily create a new, empty page. This integration enhances efficiency by allowing continuous access between Jira and Confluence, streamlining workflow and improving project management practices.

See Project pages from Jira Software

Similarly, you can compose a public Knowledge Base article directly from a request by enabling this feature in JSM.

Example 8: Publish issue data to Confluence

Want to turn your Jira issue into a Confluence page? Or include certain issue data on a page without having to copy & paste each field or download and re-add attachments? What about archiving an incident for a post-mortem? You can publish issue data, including attachments and labels, to a Confluence page with the Cloud app Elements Publish.

If you are on Data Center the on premise version of Elements Copy & Sync allows you to create Confluence pages with issue data.

Get your team using Jira and Confluence together

Enhance cross-team communication, accelerate project delivery, and streamline information retrieval by integrating Jira and Confluence. If you want to go further into the Jira and Confluence integration, check out the guides provided by Atlassian on using Confluence with Jira Software or Confluence with Jira Service Management.  To learn more about publishing issue data to Confluence pages, check out our walk through of Elements Publish.

Jira and Confluence have probably come across your radar if you’re looking to help your company move beyond an old system like managing requests by email or passing around Word documents. You want to change the culture to be more agile, to use modern techniques for workflow management and project management. Both Jira and Confluence are great to keep track of what you are working on, the status of them, and for your stakeholders to get an at-a-glance update.

But why should you use one over the other? Or should you use both Jira and Confluence? Let’s cover the basic differences and similarities of the tools and explain why and how your team should use them.

What this guide covers

What is the difference between Jira and Confluence?

Jira is a task management solution that allows you to track and manage issues throughout the lifecycle of each task. Jira can help with everything from software development to incident management or even HR processes, whereas Confluence is a wiki-based content management tool that allows you create and organize information collaboratively. Organizations commonly use Confluence for knowledge bases, product documentation, or intranets. Both are inspired by agile methodologies and are built around collaboration, but where Jira is great at tracking the status of individual tasks in standardized views, Confluence is great at bringing broader information together with an emphasis on visual presentation and creativity.

Let’s take a quick look at the major features of Jira and Confluence.

Features

Jira

Jira comes in a 3 main flavors: Jira Software, Jira Service Management, and Jira Work Management. They all share core components and logic and allow you track issues, but each is geared towards specific needs or teams.

Jira Software: Powerful and flexible, Jira Software is built for software teams using agile methodologies, and includes functionalities for sprint planning, bug tracking, and release management. Jira Software allows you to track affect and fix versions, plan epics and user stories, and analyze your sprint burn down.

Jira Service Management: The ITSM solution from Atlassian, Jira Service Management is a support desk for customers or employees to raise requests. Agents can then manage requests in queues and make sure everyone gets the help they need. JSM provides out of the box configurations for IT service management like service requests, incident management, and change management, but can also be used for facilities management, HR, or even legal teams that need to manage incoming requests.

Jira Work Management: Jira made for business teams: Jira Work Management includes calendar views, Excel-like list views, and basic forms so business teams like marketing, HR, or sales can track tasks in Jira with features adapted to their needs. JWM is only offered on Cloud, though on premise users have a similar experience with Jira Core.

Confluence

Confluence provides your organization a place to organize ideas, content, and files for all your activities. Since Confluence takes care of version control, you can treat it as your one source of truth and rest assured it will always be the up to date version. Favorite features include the search power, content organization and permission management, and the easy WYSIWYG editor.

Limitations

Jira: If you are looking for more traditional project management software, perhaps that includes project cost tracking, Jira wasn’t built for that (although there are apps on the Marketplace to add that kind of functionality). Jira is really good at tracking and reporting on individual tasks, but for a broader vision of a project or version planning, it’s better to work in Confluence.

Confluence: Confluence does include the possibility to assign tasks, but tasks are either “To do” or “Done”. If you need to keep track of a more complex workflow, Jira is a better option. Similarly, if you need to track how much time was spent on a task, Jira is a better option than Confluence.

Pricing

Atlassian sets the price of both tools based on the number of users and is digressive, but Jira is a bit more expensive per user. You can adjust how many users have access to each tool so you only pay for what you need. Jira Service Management pricing is different because it’s based on the number of agents replying to requests (customers or employees creating the requests are free).

Get an estimate for how much it would cost your organization with the Atlassian Cloud pricing calculator

Don’t forget to budget for apps so you can customize Jira and Confluence for the specific needs of your organization.

Jira vs. Confluence: Comparison Chart

Cloud versions

FeatureJiraConfluence
Assigning tasks(tick)(tick)
Workflow management(tick)(error)
Personal dashboard(tick)(tick)
Templates(error)(tick)
Support desk(tick)(error)
Knowledge management(error)(tick)
Access control/permissions(tick)(tick)
Collaborating/commenting(tick)(tick)
Roadmap planning(tick) Very detailed(tick) Basic
Project management(tick)(tick)
Calendar view of tasksJira Work Management only(error)
External app integrations (AD, CRM, Google Drive…)(tick) with apps(tick) with apps
Time tracking(tick)(error)
Native reporting(tick)Premium only

Why use Jira and Confluence together?

By using Jira and Confluence together, you benefit from their complementarity: Jira to keep track of distinct tasks individuals need to work on, and Confluence share and organize all of the ideas, content, and files you collaborate on with your colleagues.

Single source of truth

By using collaborative tools that allow everyone on your team to create, update, and share information in real time, you’ll be able to treat Jira and Confluence as your single source of truth. Whether you need to know which bug fixes are in QA review, where the most up to date documentation pages are, or the roadmap for the marketing team, Jira and Confluence allow everyone to access the same information.

Break down communication barriers

Software developers may spend more time in Jira, and business teams more time in Confluence, but by integrating the tools, everyone can access the information they need from the rest of your organization. Instead of information siloed by team, everyone can access what they need. Imagine the flow of ideas when UX designers, Product managers, and Marketing can work from the same page, instead of sharing each update or comment separately.

Improve efficiency

When requirements are listed in Confluence, and linked to Jira issues, and those issues also link to product documentation in Confluence, there’s no searching for information or struggling to make tools talk to each other. Teams that use Jira and Confluence together are more efficient because they spend less time keeping track of work and more time on the work.

How to integrate Jira and Confluence

For Cloud users, integrating Jira and Confluence is automatic as soon as you have both products on the same site. If you only have Jira or Confluence, you can add another product is just a few steps:

Step 1: Open the Settings menu from next to your user icon on the top right of Jira or Confluence, and select Billing.

Step 2: Once in your Atlassian Admin, click on Products in the top menu (between Directory and Security).

Step 3: You will see the products you currently have. Click on “Add Product” and follow the set up wizard to add the additional product to your site.

If you are using Jira or Confluence on premise (Server or Data Center hosting), you will need to go to  > General Configuration > Application links, Enter the URL of the application you want to link to, and configure with OAuth (with impersonation) authentication. Read Atlassian documentation for more details.

[vc_row][vc_column][vc_column_text css=”.vc_custom_1622193388776{border-top-width: 2px !important;border-right-width: 2px !important;border-bottom-width: 2px !important;border-left-width: 2px !important;padding-top: 20px !important;padding-right: 40px !important;padding-bottom: 20px !important;padding-left: 40px !important;background-color: #f5f5f5 !important;border-left-color: #f5f5f5 !important;border-right-color: #f5f5f5 !important;border-top-color: #f5f5f5 !important;border-bottom-color: #f5f5f5 !important;}”]

✅ Check out our guide on how to integrate Jira and Confluence

[/vc_column_text][/vc_column][/vc_row]

How to use Jira and Confluence together

A picture’s better than a thousand words, right? So here are two examples of how to use Jira and Confluence together for project management or requirements management.

Confluence and Jira for project management

Let’s take an example project you might be familiar with: migrating applications.

Many teams will start off with kick-off planning in Confluence, where you can take advantage of page templates like Project Plan, Meeting Notes, or DACI, tag everyone involved in the meeting, and start noting tasks, deadlines, and action items.

From there, you can create Jira issues for the tasks and assign them. If you are the Project Manager, you can track and share progress of the various tasks by using a filter to display all the issues related to the project on a Confluence page.

Display Jira filter on Confluence page

As the migration project continues, the team can use Confluence for functional specifications, technical documentation, and feedback on the migrated tool, with everyone on the team able to see, comment, and collaborate on those documents. Any files or assets needed can be added to each page, so team members don’t have to remember where to look on a shared drive. If configurations or features need to be reviewed once the application has been migrated, you can use a ‘Review’ status in your Jira workflow and assign the issue to a team member.

Jira and Confluence for requirements management

Create, share, get feedback, update, rinse and repeat: Jira and Confluence are the agile solution to requirements management throughout the life of your product development.

Confluence ships with a blueprint, or template, for requirements management, so you can get started right out of the gate. You can then solicit feedback and comments from multiple stakeholders, who can either comment the text directly, comment the page, or update it themselves (you can always check the page history to see the changes).

Requirements management Confluence template

If you have customer interviews or other research that is useful background information, you can link those pages directly from your requirements management page.

As the requirements are detailed, you can start creating User Stories for them in Jira directly from Confluence by highlighting the text.

If you need to include wireframes, mockups, or prototypes on a Confluence page, there are multiple apps that allow you to do that so everyone can keep all your work together. Team members can even comment mock ups just like text or other images.
Confluence automatically creates a page summarizing the main details from all your requirements management pages if you use the blueprint, so you can see at a glance the progress of all your different projects.

Get your team on Jira and Confluence

You want an agile, modern solution for your team, and Jira and Confluence provide that. By using them together, you’ll get the most out of both tools and see the benefits: a single source of truth, breaking down communication barriers between teams, and improved efficiency. The whole really is more than the sum of the parts! Curious to learn some concrete examples of the different ways you can use Jira and Confluence together?

Read 8 different ways to use Jira and Confluence together

We at Elements like a challenge, so naturally participating in Atlassian’s Codegeist is something we look forward to each year. What is Codegeist? It’s the annual developer contest that helps teams unleash their potential by building Atlassian apps. In 2020 we submitted beta versions of our Jira cloud apps Elements Connect as well as Elements Copy & Sync. We were in the starting blocks this spring, waiting for the 2021 contest. Finally this summer (for us in the northern hemisphere 😉 ) they announced it! Check out the Codegeist 2021 details and project gallery over on Devpost.

But this year it was all on Forge 😮  (okay we weren’t actually that surprised; Forge is the future of apps for Atlassian). Here’s the behind the scenes experience of our submissions SkillQuest and Office Manager.

What is Forge?

Forge is Atlassian’s new developer framework, and since it will probably be the main developer platform in the future for Atlassian apps, we actually didn’t wait for Codegeist to start to get our hands dirty. With some developers, we started “Forge Sessions”, a dedicated time to learn and explore Forge by creating apps with a real purpose. Once the Codegeist was announced, we figured it was a good opportunity to propose some of our most advanced prototypes.

Our experience developing on Forge

What we liked

Right away, we liked working with Forge because it is so fast to get a functioning app deployed on our Atlassian products. The Forge environment is really developer friendly (our thought is that non-developers are targeted by this framework). Also the fact you don’t have to worry about the infrastructure really gives you peace of mind. Forge provides Function as a Service (FaaS) to developers. All you need is to write a Javascript / Typescript function with your business logic inside, then register its name to your app manifest. Forge will automatically deploy it into an isolated FaaS environment.

What was frustrating

But we couldn’t help feeling frustrated by some lack of functionalities due to the framework being so recent. As an example, some cool locations like the Jira general pages or post installation pages are not available yet. Some new comers, like UI Kit (which allow you to build interfaces for your application) would require more components to address more common use cases. We also ran into several Forge APIs that don’t have a Typescript declaration (or are not completely typed) which can slow down development.

Even though Forge doesn’t contain all the features of is big brother, Atlassian Connect, the team is really reactive (with at least one release each two weeks) and some of the missing features are already listed on the Forge Roadmap.

Testing Forge Storage

During the process of creating an application with Forge, our plan was to not use an external backend (using a Cloud provider). Everything should be handled by Forge functions, in order to deeply test the possibilities of the framework and to quickly develop our prototypes. Note that it’s possible to build Atlassian Connect apps on Forge, to use feature of both frameworks, but it’s still in beta. This approach lead us to work heavily with a new feature: the Forge Storage, a place to store dictionaries of data, which are dedicated to our app and a tie to an Atlassian instance. Again, the Forge Storage API is recent and doesn’t provide a lot of advanced features (like advanced query or results sorting) but can be used anyway.

In the end, our Elements developers worked on 6 apps, and we submitted SkillQuest and Office Manager early September 2021. It was a bit tricky since the contest ran during our summer and some team members were on vacation, but we’re proud of what we were able to submit.


SkillQuest for JiraOffice Manager for Jira

For anyone looking to give Forge a try, some knowledge of Javascript / Typescript and some basic concepts of Jira and Confluence are necessary to be able to create an app. It should be noted that the Atlassian community for Forge was really reactive and a big help for anyone developing on Forge. 

What we learned along the way

The great thing about participating in Codegeist was that we learned just how fast you complete an app with Forge.

One of the most challenging features we worked on was the Office Manager office editor was the most complex part. We had to go back to trigonometric math and transformation matrix; that’s not something we do often when developing Jira add-ons!

Retrospectively, we wouldn’t do it the same way. It was really fun to do and a great opportunity to play with HTML Canvas, but unfortunately it’s now very complex to add some features to the map. It we had to redevelop the office editor, we’d check for third-party library first and if nothing match our need, develop by our own with maintainability as a priority.

For the future

At Elements, we will continue with our Forge sessions, and we want to explore the “Connect on Forge” app side to prepare a potential migration of our existing Atlassian Connect apps. We plan on utilizing what we learned through our participation in Codegeist by bringing everyone on our team up to speed on Forge. We’ve created a sample app developers create as an exercise so they familiarize themselves with all the features on Forge.

To learn Forge, our developers have to connect Jira to Cat as a Service so that cute cats are automatically added to new issues. The goal of the exercise is create an app with this structure that uses:

  • and also Forge triggers to automatically generate a cat picture once the issue is created;

Forge structure Jira practice app

with an end result that looks like this.

You probably already use Jira and Confluence together, for example adding a link to a Confluence page to a Jira issue or creating a Jira issue by highlighting text on a Confluence page.

But what about creating a Confluence page from a Jira Cloud issue? We’re thrilled to share that it’s now possible with our new app for Jira Cloud: Elements Publish to Confluence.

Elements Publish to Confluence simplifies the process of creating a Confluence page directly from Jira, 0 scripting or webhooks required, and it can be set up in minutes for teams using Jira Software, Jira Service Management, or Jira Work Management.

Create a Confluence Page from Jira

Elements Publish to Confluence lets you design templates to publish issue data to Confluence as part of your team processes. Each recipe allows you to design a different page, specify where it will be created in Confluence, and from which Jira issues it can be used.

When creating your template, you can insert issue data, specify whether or not labels and attachments should be copied from Jira to the Confluence page, and also decide if you want a link added.

Elements Publish to Confluence app for Jira

In Jira create Confluence page from template

It’s easy to set up a recipe in Elements Publish to Confluence.

Step 1: Define where the recipe will be available

Do you want to create a page for bug analysis? Make your recipe only available for bug issues. Need to publish issue details for a post-mortem? Set the issue type then the status to resolved (tip: you can trigger the recipe when the issue is resolved). Want to create a page for marketing campaign notes? Make the recipe only available in the Marketing project.

Step 2: Define where the page will be created

If we could read your mind, we would. But for now you need to chose the Confluence space and the parent page where you want the new page to be created.

You can also activate in the Target tab the option to automatically add a link to the Confluence page in your Jira issue.

Step 3: Design your page

Finally the good stuff!

The in-app text editor lets you configure the content and layout of your document. With the wysiwig editor, it’s easy to insert data from your Jira issue into your Confluence page, and you know what your page will look like.  To provide a complete picture of what is in the Jira issue, you can also copy attachments and labels to your Confluence page.

Is your team already using Confluence templates, like the ones provided by Atlassian or maybe one you created? No worries, you can keep using them: you can inject Jira data into any existing Confluence template.

💡 Tip: set up the page title combining static text like “Bug analysis of:” with details from the issue like the summary or key. Your page title will be dynamically created each time the recipe is used.

Activate your recipe, and you’re ready!

Trigger Confluence page creation automatically from Jira with a post-function

Has your team forgotten to create and link the bug analysis/post-mortem/knowledge base article AGAIN?

Make it easy for everyone by adding a recipe as a post-function to a workflow transition. When Jira users transition the issue, the new page will automatically be created in Confluence. This is a perfect opportunity to use the issue summary to dynamically create the page title since users won’t be able to modify the page title when the recipe is triggered by a transition.

If you have several post-functions already added to your workflow transition, you may want to add a few seconds delay to the execution of the Elements Publish to Confluence recipe to optimize the performance of your instance.

Publish to Confluence: post-mortems, meeting notes, marketing campaigns & more

Elements Publish to Confluence can help lots of different teams that need to regularly create pages with details from Jira, no matter whether they are using Jira Software, Jira Service Management, or Jira Work Management. Here are some of our favorite use cases:

  • Bug analysis: insert details from bugs raised on your support portal onto a Confluence page so team members can add details and analysis
  • Post-mortem: add the recipe as a post-function to a workflow transition and automatically create a post-mortem in Confluence and insert details from your Jira issue when you transition the incident to closed
  • User story details: insert details from the User story and Epic onto a pre-formated Confluence page to add details
  • Release details: automatically generate a Confluence page with all the details from a release ticket when you transition it to done by adding the recipe as a post-function
  • Knowledge Base article: apply labels from the Jira issue to your Confluence page and make information easily searchable
  • Meeting notes: use the dynamic page title option to generate a page for notes based on the summary of the issue and activate the link option so meetings notes are easy to find from the issue
  • Marketing campaign: insert all the campaign details and collaterals from your Jira issue onto a Confluence page and get started on the details of your marketing campaign
  • Employee onboarding: new hire request received on Jira Work Management? Publish all the details on a Confluence page where the manager or team members can add details
  • RFP process: Jira Work Management forms are perfect for the RFP process, and everything submitted can be easily published to a Confluence page for the next step in the process

Have you made it this far only to realize this won’t work for you because you are on Jira Server or Data Center? We’ve got you covered: our on premise version of Elements Copy & Sync allows you to create Confluence pages.

Start creating pages from Jira

Sound like something your team would like? Get started with a free trial, then let us know what you think.

See app on Marketplace

What do you do when it’s been 15 months since your entire team has been in the office, and you also want to improve your web application security skills? A hackathon!

Catch the flag hackathon at Elements

With Covid restrictions lifting and the vaccination rate increasing, the Elements engineering team organized an in person, in office hackathon focused on security vulnerabilities, with a little help from the local pizzeria 😉

Preparing the hackathon

Security is a big priority for our teams, and Elements’ participation in Atlassian Bug Bounty means engineers are regularly working to improve our apps’ security. But why wait for bugs to be found when you can develop your skills as a team? Software developer Houssem Aloulou had previously participated in and helped organize Hackfests during his studies in Tunisia, and had lots of ideas about how Elements could hold its own hackathon. Focused on web application security, Houssem prepared the event using the Catch the flag (CTF) format.

Houssem Aloulou presenting challenges

“I chose the Catch the Flag format because it’s culture is really rich, with a focus on the experience, where collaborating and sharing knowledge between team members is the main focus.”

Ready, set, code!

On Monday June 21, 19 Elements engineers were randomly split into 5 different teams to work on the 9 challenges. Equipped with fun t-shirts and snacks, engineers worked from 10 am to 4pm.

Each challenge earned teams a number of points based on the difficulty, and with half an hour to go before the end of the day, team <script>alert(*La Bamboche*)</script> finished all 9 challenges, with team ILOVEYOU in a strong second place just 2 minutes later.

Elements hackathon winning team

Houssem explains how he set up the challenges: “I took examples from real security problems we have faced, and wanted participants to think about the impact of those kinds of bugs. The challenges used several servers with several vulnerabilities, and the team that exploited the vulnerability found the flag.”

Each challenge earned teams different points, based on the difficulty, but using hints reduced the earn-able points. Some people tried to get Houssem to reveal a few secrets, but his lips were sealed! An hour before the end of the event, the team scores were hidden so teams didn’t know how close the competition was.

Hackathon team scores Elements

Looking back, and to the future

What did participants have to say about the event?

“A playful way to increase awareness around the different types of attacks and also to work as a team.”

“Inter-squad teams, working together, the escape game feeling: overall a great way to commit to memory the most important topics related to security.”

Based on the feedback, we hope to repeat the event in the future, potentially with more diverse challenges including server breach, man in the middle or other topics.

Sound like an event you’d like to participate in? We’re hiring!

Check out open positions on our Careers page

Cloning and moving is the most time efficient solution to make existing information useful for other people or additional situations within Jira. A classic example is issue escalation, where you need to clone an issue from your support portal to a software team. Or maybe you have issues created regularly by internal employees, and you want to be able to clone an issue to another project based on a custom field.

What are the options for automating a process to clone and move Jira issues based on a custom field? We’ll take a look how you can clone and move Jira issues based on a custom field with native Jira options, as well as with an app. We’ll also see how automating copies as part of a workflow transition with Elements Copy & Sync can help your team.

Jira out of the box clone and move options

Issues can be cloned and moved individually with native Jira features available from the action menu. The manual process is fully detailed in our Ultimate guide to clone and move Jira issues.

Jira native clone option from more menu

How frequently do you need to clone and move issues? If it’s just a couple times a month, this could be the best option. Jira users would just need to check the details in the issue, and move the clone manually. Note you can’t see the issue details after you click on Move, so if you need to select a project based on those details, make a mental note beforehand.

How to clone issue to a different project based on a custom field

Looking to make the process automatic? Or reduce the risk of errors? You can streamline the process (and prevent moving issues to wrong projects)  by using an Elements Copy & Sync operation (Server or Data Center) or recipe (Cloud). It works by

  1. setting a project picker custom field,
  2. launching the Copy & Sync operation/recipe, and
  3. creating a linked clone in the right project.
Preview of clone and move operation in Jira

Let’s look at how you can set this up on Jira Server or Data Center. If you are on Jira Cloud, follow this Elements Copy & Sync Cloud tutorial.

Step 1: Create a project picker custom field

From your Jira admin, create a new custom field, selecting “Project Picker” from among the Advanced field types. Give it a clear and understandable name that is unique to your Jira instance, and save.

Step 2: Add project picker custom field to issue screens

Don’t forget to associate your custom field to all the various screens where you’ll need it, like the view/edit screen. New custom fields are added to the end of the tab on the create issue screen, so you may need to adjust the order of your fields.

Step 3: Configure Copy & Sync operation

If this is your first time configuring Elements Copy & Sync, you will need to create a field mapping before creating your operation.

Once you have a field mapping, you can create a copy operation. When configuring the operation, instead of selecting one project or a category of projects, select “From Custom Field”, and then chose the project picker custom field that is displayed.

Step 4: Clone and move issue based on your custom field

From your issue, make sure your project picker field has a value, then click on the Elements Copy & Sync operation button to create the clone in the right project. In this example, the operation also adds a link between the clone and original issue.

Trigger clones as part of a workflow and create on transition

Copy & Sync operations can be added as post functions to workflow transitions to make the process even smoother. Elements Copy & Sync will automatically clone issues to the right project when you transition issues.

To add an Elements Copy & Sync operation to a transition, you will need to edit your workflow and add a post-function.

Once you’ve published your new workflow, you probably want to add the project picker custom field to the transition screen that will trigger the operation so that it’s easy for agents to update the field. This is what that process could look like:

This example also includes an Elements Copy & Sync Data Panel on the incident issue, which helps you customize the information you display from linked issues (for comparison, the cloned issue in the software project has the native linked issue panel).

Using the operation as part of a workflow transition was smooth and easy: support agents can follow their usual process and transition issues, then go back to their queues. All the important information from the source issue has been cloned in to the right project for the software developers.

Automated cloning and moving is a recipe for success

The combination of native Jira project picker custom fields with the app Elements Copy & Sync is a recipe for success for cloning and moving issues to different projects (you could even say it makes it a piece of cake 😉 ). All Jira users can confidently clone and move issues based on a custom field, without worrying about remembering which project to chose. Adding the clone and move operation to a workflow transition means reducing the risk of errors as well. You can even compare the number of clicks required to manually clone and move an issue versus using Elements Copy & Sync!

Curious how a real company implemented Elements Copy & Sync to escalate issues from a support portal?

Read the Olive Communications story to learn more.

There are lots of reasons you might need to clone and move a Jira issue: escalating a ticket from a service desk project to a software project, replicating a task from one Jira project to another, or maybe making issue details available to someone who doesn’t have permissions on the original project.

While cloning an issue and moving it are available out of the box in Jira, there are other solutions to consider. By understanding the different options to clone and move, you can get the most out of Jira and optimize your processes.

Let’s look at the ins and outs of cloning in Jira.

What we’ll cover in this guide to cloning and moving

  1. When to clone an issue to another project
  2. Jira clone vs duplicate
  3. How to clone and move issues in Jira
  4. Permissions: how to control cloning and moving in your Jira instance
  5. Use case: cloning and moving from Jira Service Management to Jira Software
  6. Pro tips checklist for managing how users clone and move issues in Jira

When to clone an issue to another project

Cloning and moving is the most time efficient solution to make existing information useful for other people or additional situations within Jira. There are lots of use cases where it might make sense to clone an issue to another project:

  • move issues from the Designer’s board to the Developer’s project
  • share a bug or change request from a support portal with an engineering team
  • need to clone between Company managed and Team managed projects
  • move/clone issues from instance A to B, and vice versa
  • replicate an epic issue for multiple teams that each have a project
  • clone a task from current project to add it to an epic in another project

After all, you already have lot of information from a customer or an employee, and you probably spent time configuring all those fields. Make sure that information is used again and help your entire team leverage the power of Jira!

Jira clone vs duplicate

Jira has its own jargon, so just to be clear, when linking two issues on JIRA, what is the difference between one issue “cloning” another, and an issue “duplicating” another?

difference between one issue "cloning" another, and an issue "duplicating" another

The words are synonyms in many situations, but when we’re talking Jira, a clone is an issue that was created by copying another issue, and a duplicate is an issue that repeats another issue. For example, a duplicate happens often when two clients raise the same bug: often the second/third/nth person doesn’t know that it’s already been reported.

There are a number of links you can add between issues, and clone and duplicate are two on the list that may seem to be identical, but actually serve a different purpose.

How to clone and move issues in Jira

The methods to clone and move issues basically fall under two main categories: native Jira functionalities, or add-ons.

Options to clone and move issues in Jira

In the add-ons category, you can choose from solutions like Automation (which now is included free with Jira Cloud), or other apps available on the Atlassian Marketplace.

Let’s take a look at the pros and cons of various solutions to get a better idea of the situations for which they are the most suited.

Option 1: Native Jira options to clone and move issues

Every Jira instance offers out of the box the clone feature and the possibility to move issues. Both clone and move are available from the Actions menu.

Jira native clone and move in actions menu

To clone an issue, just select clone from the Actions menu. Jira automatically adds “CLONE” to the beginning of the summary of the new issue, and you can activate the option to clone attachments if you want. No other options are available.

Jira native clone issue with attachment

You can then move this issue to another project. First you need to select the destination project and the issue type. The drop down field to select the project shows you first the projects you selected recently, and then below all of the projects you have access to in the instance. After confirming the target project and issue type, you have to map the statuses, and then update any fields. If your new issue has any custom or required fields (like a story points estimate for a Story issue), you may need to complete that before you can finish moving the issue.

Move Jira issue with native functionality

Once you’ve moved your issue on Jira Cloud, you will still have the clone link to the original issue, so if you don’t want that you can remove it. If you are using Jira on premise, you won’t have this clone link.

How to remove jira cloned link

When moving an issue that has custom fields to another project, you need to make sure the custom fields exist on the target project. Even if the custom fields do exist, you may still be prompted to set values for them in order to finish moving the issue. If you are using Jira Cloud and trying to clone and move between Team managed and Company managed projects, be aware that you may not be able to clone everything from the issue since Team managed projects are self-contained and do not share custom fields with other projects.

Want to better manage your custom fields in Jira? Check out our guide to custom fields.

Pros and cons to native Jira options to clone and move issues

Pros and cons to native Jira options to clone and move issues

Built in cloning in Jira lets you clone most things from the issue, including attachments, and it’s relatively simple to use.

Moving issues with the native Jira function is pretty straightforward too. There’s nothing to configure ahead of time, you make all the choices each time you want to clone and move an issue.

But this process can be really cumbersome if you

  • need to do this regularly,
  • need several team members to do this,
  • have dozens or hundreds of projects on your instance,
  • want changes on the original issue to be synchronized to the clone
  • or need to clone time tracking, comments, or links to Confluence pages.

Or maybe you just want custom fields to be cloned without having to set values each time. Let’s not even count the number of clicks you need to do to clone and move one issue with 2 custom fields and then remove the clone link!

When to go with native Jira functionalities

For a small instance with a small team, cloning and moving with the native Jira options is a solution without any added cost or configuration, but the risk of error and time spent on the process only increases when you have lots of projects or a larger team cloning and moving. This solution works to clone attachments, some custom fields, but not comments.

Option 2: Automation options to clone and move issues

Automation is now included in Jira Cloud instances, as well as being a paid app for on premise instances, and you might already be using it for other use cases (like automatically closing a Service Management issue if the customer doesn’t reply for a certain number of days).

Automation can be configured to clone an issue, or to create a new issue in a different project and copy values between the two issues.

You can get started using Automation for Jira Cloud by getting some automations from the template library.

The template library includes an example automation

When issue is transitioned → clone issue to another project and link the two issues 

Automation template library rule lone issue to another project and link the two issues

If you are using Jira on premise (Server or Data Center), the documentation on how to clone an issue with Automation is available here. The clone made with Automation for Jira will not copy attachments, issue links, or comments, but you could configure additional rules to sync comments, for example.

Pros and cons to Automation for Jira to clone and move issues

Pros and cons to Automation for Jira to clone and move issues

Automation for Jira is now included in Jira Cloud instances, and you might already be using it for other use cases. It’s a powerful app with a large community.

But “now included in Jira Cloud” comes with some important caveats:

  • While an automation to clone issues within just one project can have unlimited executions, an automation rule that is applied to more than one project, it’s considered a global rule and will be limited.

There are some additional caveats that rules to create issues are not counted even if the issue is created in a different project.

Setting up an automation rule is also not the most intuitive task. Choosing which fields you want to clone has to be done field by field. And specifying additional field values to be set using a JSON objector is another way of saying “we hope you are ready to spend lots of time on the documentation”.

Automation for Jira field update

You can trigger rules manually or automatically so either users decide when to execute the automation or it’s executed automatically, but Automation is at its most powerful when everything is triggered automatically.

When to go with Automation for Jira app

If specifying valid JSON objects for advanced field cloning is a piece of cake and your team has structured and complex processes for using Jira, Automation could be the right solution for you. You will have more control over cloning custom fields compared to the native options, but you will need to spend considerable time configuring and maintaining your rules. You will also lose the possibility to clone attachments.

Option 3: Clone and move plugin Elements Copy & Sync

A number of apps allow more flexibility to clone and move issues to better meet your needs, and Elements Copy & Sync offers a balance of robust features with user friendly configuration.

In order to clone and move an issue, you will need to first configure a recipe, which lets you specify conditions for the issues to be copied (projects, issue types, priority, etc), conditions for where the clone will be created (project and issue type). This can be a set project or issue type, or a selection the user can chose from. To complete the recipe, you need to specify what will be cloned: fields, attachments, and comments. You can chose to clone all available fields, or only some, for instance excluding certain custom fields. The field mapping options are really easy to use to copy information to different fields, for example copying the Description or Root cause of the source issue to the Environment field on the new issue.

Once you have activated your recipe, you can select it from the Copy & Sync window available through the Actions menu. You can also add the recipe as a post-function so it clones an issue to another project as part of a workflow transition.

Pros and cons to clone and move plugin Elements Copy & Sync

Pros and cons to clone and move plugin Elements Copy & Sync

Using an app like Elements Copy & Sync allows you to configure

  • very specific clone and move recipes,
  • specifying which fields to copy (and where),
  • whether or not you want attachments and comments copied, and
  • if set as a post-function it executes in the background for no extra clicks for your user.

Users are guided in what they clone and move, with a streamlined process, so the risk of error is drastically reduced compared to the native functionalities. Configuring recipes is much easier than configuring automation rules, especially if you want to modify which custom fields you clone. If you are using Jira on premise, Elements Copy & Sync lets you create remote issues as well. You can copy attachments and comments with the app.

As an add on, there is an added cost to take into consideration.

When to go with Elements Copy & Sync app

If you want to streamline your clone and move processes to reduce errors and want app configuration and maintenance to require a minimum amount of time, Elements Copy & Sync could be the right solution for you.

Permissions: how to control cloning and moving in your Jira instance

With a handful of users, controlling who can clone and move issues on your instance might not seem like an essential need. But as the adoption of Jira spreads throughout your company, the risk of mistakes increases too. What if from the original 10 projects, you now have 60? Cloning the wrong issue or moving a clone to the wrong project is an easy mistake to make, which then requires additional clean up work and regular vigilance.

Setting permissions with native Jira clone and move options

For setting cloning permissions, you can remove cloning options for all users on Jira on premise, but you can’t deactivate cloning for only a subset of users with the OOTB functionalities. You can set move issues permissions based on roles, but users need to have create issue permissions in the project where they are moving the issue.

Setting permissions with Automation

Conditions can be set on rules to check whether a user exists or is in a specified group before executing an automation, which can let you limit issue cloning to a subset of users.

Setting permissions with Elements Copy & Sync

Elements Copy & Sync Cloud lets you restrict which issues can be cloned based on issues details (like the type, priority, or a specific JQL filter) and restrict where it can be cloned. If you only want certain issue types or issues of a certain priority or in a certain status to be able to be cloned as part of an escalation process, you simply need to set up the recipe with that criteria, and users will only be able to use the recipe when the issue meets all the criteria.

You can also set permissions based on roles. You can define specific permissions on the user, group or role (on premise only) of the person who is triggering the clone.

See how this works on the Activation tab with the on premise version, or the Triggers tab in cloud version.

Use case: cloning and moving from Jira Service Management to Jira Software

Here’s a pretty common use case for teams looking to clone and move an issue: a customer raises a request on a Jira Service Management portal, and it requires the work of the software team. The details of the bug the customer reported need to be cloned and moved into the software developer’s project where they can add it to their next sprint.

Using Elements Copy & Sync for issue escalation

This is how Elements Copy & Sync can be used to clone and move issues easily for issue escalation.

Here is the summary of the recipe that has been set up.

how Elements Copy & Sync can be used to clone and move issues

As you can see on the Source and target section, the recipe is available for all issue types on the Tellurian Support Desk that are In Progress, and creates the clone in one of three pre-selected projects, as a bug, and with the link ‘blocks’.

In the Created content section, there’s a quick view of whether fields, comments, and attachments from the source issue will be copied, and synchronization has also been activated (any changes in the original ticket on the support desk like a field change or new attachment will be synchronized to the clone).

This is what it looks like for an agent using the recipe from Jira Service Management:

Beyond strictly cloning and moving the issue from the service desk to the software project, there are also a couple things that would be handy in this situation that are available with Elements Copy & Sync:

See linked issues on customer portal

Having the status of the cloned issue visible on the customer portal so they can stay informed of the progress. Your users will need to have permissions on the linked issues.

comments and attachments synchronized in Jira clone

Having fields, comments and attachments synchronized from the JSM issue to the Software issue so the developers get any new information the customer might add to the issue after the initial clone was done. You can choose which way information is synchronized.

Pro tips checklist for managing how users clone and move issues in Jira

  • Make sure Jira users are correctly assigned to roles or groups, especially if you are going to limit move issue permissions based on those roles
  • Look at the custom fields in the different projects to make sure the cloned issue in a new project remains coherent
  • Check your source et destination workflows
  • Ask your project admins or heavy Jira users how they want users to be able to clone and move issues: individually? choosing the target project themselves? invisibly in the background as a post-function? in bulk?
  • Try any clone and move app in a staging instance first

By picking the best option for your needs to clone and move Jira issues, you can make sure you’ve optimized your instance for your users and simplified your job taking care of the instance.

Read our article on how to clone and move issues based on a custom field