Jira Software is a project and issue tracking tool for agile teams. Use Jira Software to plan, track, and manage releases for digital products:

• Create projects using Kanban boards, Scrum boards, or roadmaps.
• Plan sprints, prioritize and distribute tasks across your software team.
• Access reports with real-time, actionable insights into how your team is performing.
• Connect Jira Software to other Atlassian tools.

You can connect Figma to Jira Software. This allows you to add design files and prototypes to issues or epics in your Scrum or Kanban boards.

Install the Figma for Jira app

Before you can embed files and prototypes in Jira Software, you will need to add the Figma app to your Jira account.

You can do this from anywhere inside your Jira account.

1. In the main menu, go to Apps > Manage your apps.

   

2. Click Find new apps in the left sidebar and search for the Figma app.

   

3. Click on the Figma app in the results, then click Get app in the top-right corner of the app listing.

   

4. Click Get app to add the Figma app to your account.

   

Once you've installed the Figma for Jira app, your Jira issues will have a Designs section. This is where you can add and view Figma Live Embeds.

Add a file or prototype to Jira

You can embed any file or prototype, regardless of the file's link sharing settings. Collaborators can interact with Figma Live Embeds based on:

• Their team or Organization permissions
• The file's sharing settings

Link a design file in Jira Software

You can link multiple Figma files to issues and get notified when designs are updated, without leaving Jira.

When you add a design to an issue, the Jira link is automatically added under the Figma file’s Dev resources in Dev Mode. You can click on the Dev resource link to open the issue in the Jira plugin, without leaving Figma.
Learn more about using Dev resources in Dev Mode →

1. Open the Jira issue you want to add an embed to.
2. If the Designs section isn't shown, click Add design under the title. You can also click Sync to view any previously linked designs. 
3. Paste the Figma URL in the field and click Link. 
4. You can now view the file  without leaving Jira. Click on the thumbnail to expand the design preview. Clicking on a prototype will open the file in a new tab.
5. Click in the Designs section to link multiple files.

Link a design file with the Jira plugin

Get full context when turning designs to code with the Jira plugin. With the plugin, you can link Jira issues to Figma pages or layers so you always have the relevant information you need.

Use the Jira plugin to:

• Import and link existing Jira issues to pages or layers in a Figma file, so that developers have all the relevant context they need easily accessible.
• View linked Jira issues directly in Figma, to reduce context switching during design implementation.
• Create new Jira issues directly from Figma, to stay in flow even if you realize new issues need to be created as part of planning or handoff.

When you link a design to an issue using the Jira plugin, a link to the design file is automatically added to the Jira issue, under the Designs section.

Check out the Jira plugin in the Figma Community →

To use the Jira plugin in Figma:

1. Run the Jira plugin from your design file. The plugin is available in both Design Mode and Dev Mode.
   Learn more about using plugins in files →
2. Select the specific page or layer you want to embed.
3. Click Create issue to add a new issue in Jira, or Link issue to connect an existing Jira issue to your selected page or layer.
4. Once an issue is linked, you’ll be able to view its details within the Jira plugin.

Create issues from the Jira widget

Use the Jira widget to pull Jira projects and all of their associated issues into the canvas to discuss and update with your team. Adjust assignee, priority, status, and issue type right in Figma or FigJam, while maintaining your source of truth in Jira. You can easily capture them as new to-do’s as issues in Jira, and even link associated designs from Figma.

Check out the Jira widget in the Figma Community ->

In Figma Design

When you run the Jira widget from a design file, you can either create an issue from the design, or import an existing issue or project.

Learn more about using widgets in files →

To create an issue from a design:

1. Click Create issue from design in the widget.
2. Add a brief Summary of your issue.
3. Select where to add the design from. You can add designs from a selected frame, your current page, or by pasting in a Figma link.
4. Select a Project from the dropdown to add the new issue.
5. Select an Issue type from the dropdown.
6. Click Create to generate the issue. You’ll see the issue as a draggable object in the file.

In FigJam

When you run the Jira widget from a FigJam file, you can either turn stickies into issues, or import an existing issue or project.

To turn stickies into issues:

1. Select a single sticky or multiple stickies to turn into issues.
2. Click Turn stickies into issues in the widget.
3. Select a Project from the dropdown to add the new issue.
4. Select an Issue type from the dropdown.
5. Click Convert stickies to generate the issues. You’ll see the sticky turn into a draggable issue in the canvas.

View Design updated tags

To see the Design updated tag on a design thumbnail, ask your Jira administrator to Connect Figma to Jira under Get design updates. This tag will be visible if a linked design has been updated since you last viewed an issue. 

Your Jira administrator will need to add Figma team URLs for all teams using a Jira site. They must be a Team admin to connect the Team ID.

To find your team URL in Figma:

Enterprise plans

1. Click on All workspaces in the left sidebar of the file browser. 
2. Under Your teams, right-click the specific team.
3. Select Copy link. 

Org plans

1. Click on All workspaces in the left sidebar of the file browser. 
2. Right-click the specific team.
3. Select Copy link. 

Starter/Pro plans

1. Right-click the specific team in the left sidebar of the file browser.
2. Select Copy link to team. 

Automate workflows with linked designs

Save time by automating manual processes to improve collaboration between design and development teams. Use design automation in Jira to notify developers of changes to designs, transition issue statuses, and easily add labels to issues with designs.

To set up automations with linked designs in a Jira project:

1. Go to Project settings > Automation in the left sidebar.
2. Click on the Templates tab.
3. In the Design section, select the automation you want to set up.
4. Click Turn on rule. Next to the rule name, you’ll see its status change to Enabled.

You can disable or delete an automation from the Rules tab under Automation.

Learn more about automating tasks and processes in Jira →

Remove Figma from Jira

You can remove a single embed, or uninstall the Figma app to remove the app and all Figma embeds.

Remove an embed

If you want to delete a specific file or prototype, you can remove it from the issue in Jira.

1. Open the issue you want to remove the embed from.
2. Click Remove design next to the embed.

3. Jira will remove that embed from the issue.

Remove the Figma for Jira app

If you want to disconnect your Figma account from Jira, you can uninstall the Figma app. This will also remove any file or prototype embeds from your board.

1. Open the board in Jira.
2. Click Apps in the menu bar and select Manage your apps.
3. Click on the arrow next to the Figma application to expand.
4. Click the Uninstall button: