User Guide Cancel

Jira integration for XD

  1. Adobe XD User Guide
  2. Introduction
    1. What's new in Adobe XD
    2. Common questions
    3. Design, prototype, and share with Adobe XD
    4. Color Management
    5. System requirements
      1. Hardware and software requirements
      2. Adobe XD, Big Sur, and Apple silicon | macOS 11
    6. Workspace basics
    7. Change app language in Adobe XD
    8. Access UI design kits
    9. Accessibility in Adobe XD
    10. Keyboard shortcuts
    11. Tips and tricks
  3. Design
    1. Artboards, guides, and layers
      1. Get started with artboards
      2. Use guides and grids
      3. Create scrollable artboards
      4. Work with layers
      5. Create scroll groups
    2. Shapes, objects, and path
      1. Select, resize, and rotate objects
      2. Move, align, distribute, and arrange objects
      3. Group, lock, duplicate, copy, and flip objects
      4. Set stroke, fill, and drop shadow for objects
      5. Create repeating elements
      6. Create perspective designs with 3D transforms
      7. Edit objects using Boolean operations
    3. Text and fonts
      1. Work with drawing and text tools
      2. Fonts in Adobe XD
    4. Components and states
      1. Work with components
      2. Work with nested components
      3. Add multiple states to components
    5. Masking and effects
      1. Create a mask with shapes
      2. Work with blur effects
      3. Create and modify gradients
      4. Apply blend effects
    6. Layout
      1. Responsive resize and constraints
      2. Set fixed padding for components and groups
      3. Create dynamic designs with stacks
    7. Videos and Lottie animations
      1. Work with videos
      2. Create prototypes using videos
      3. Work with Lottie animations
  4. Prototype
    1. Create interactive prototypes
    2. Animate prototypes
    3. Object properties supported for auto-animate
    4. Create prototypes with keyboard and gamepad
    5. Create prototypes using voice commands and playback
    6. Create timed transitions
    7. Add overlays
    8. Design voice prototypes
    9. Create anchor links
    10. Create hyperlinks
    11. Preview designs and prototypes
  5. Share, export, and review
    1. Share selected artboards
    2. Share designs and prototypes
    3. Set access permissions for links
    4. Work with prototypes
    5. Review prototypes
    6. Work with design specs
    7. Share design specs
    8. Inspect design specs
    9. Navigate design specs
    10. Review and comment design specs
    11. Export design assets
    12. Export and download assets from design specs
    13. Group sharing for enterprise
    14. Back up or transfer XD assets
  6. Design systems
    1. Design systems with Creative Cloud Libraries
    2. Work with document assets in Adobe XD
    3. Work with Creative Cloud Libraries in Adobe XD
    4. Migrate from linked assets to Creative Cloud Libraries
    5. Work with design tokens 
    6. Use assets from Creative Cloud Libraries
  7. Cloud documents
    1. Cloud documents in Adobe XD
    2. Collaborate and coedit designs
    3. Coedit documents shared with you
  8. Integrations and plugins
    1. Work with external assets
    2. Work with design assets from Photoshop
    3. Copy and paste assets from Photoshop
    4. Import or open Photoshop designs
    5. Work with Illustrator assets in Adobe XD
    6. Open or import Illustrator designs
    7. Copy vectors from Illustrator to XD
    8. Plugins for Adobe XD
    9. Create and manage plugins
    10. Jira integration for XD
    11. Slack plugin for XD
    12. Zoom plug-in for XD
    13. Publish design from XD to Behance
  9. XD for iOS and Android
    1. Preview on mobile devices
    2. Adobe XD on mobile FAQ
  10. Troubleshooting
    1. Known and fixed issues
      1. Known issues
      2. Fixed issues
    2. Installation and updates
      1. XD appears as not compatible on Windows
      2. Error code 191
      3. Error code 183
      4. Issues installing XD plugins
      5.  Prompt to uninstall and reinstall XD on Windows 10
      6. Issues with preferences migration
    3. Launch and crash
      1.  XD crashes when launched on Windows 10
      2.  XD quits when you sign out of Creative Cloud
      3. Issue with subscription status on Windows
      4. Blocked-app warning when launching  XD on Windows
      5. Crash dump generation on Windows
      6. Crash log collection and sharing
    4. Cloud documents and Creative Cloud Libraries
      1. Issues with XD cloud documents
      2. Issues with linked components
      3. Issues with libraries and links
    5. Prototype, publish, and review
      1. Unable to record prototype interactions on macOS Catalina
      2. Issues with publish workflows
      3. Published  links do not appear in browsers
      4. Prototypes do not render correctly in browsers
      5. Commenting panel suddenly showing up on shared links
      6. Unable to publish libraries
    6. Import, export, and working with other apps
      1. Import and export in XD
      2. Photoshop files in XD
      3. Illustrator files in XD
      4. Export to After Effects from XD
      5. Sketch files in XD
      6. Third-party apps not visible in Export

Learn how to enable Jira integration for XD.

Adobe XD and Atlassian Jira bring creative work and teamwork together. With the Adobe XD for Jira app, designers can easily share their latest prototypes and design specs with other stakeholders in Jira.

  1. Log in to your Jira instance as an admin.

  2. In the sidebar, click Jira Settings and then choose Apps > Find new apps. The Atlassian Marketplace for Jira page appears. 

  3. Search for Adobe XD. From the search results, click Install for Adobe XD.

  4. In the Confirm app installation dialog box, click Accept & install. A confirmation message is displayed when the app is successfully installed.

  5. By default, all the projects within the workspace are enabled to show the app within a Jira issue. However, as an admin, you can choose to enable the add-on only for specific projects. To change the default configuration, do the following:

    1. Go to Manage add-ons page from the sidebar.
    2. In the User-installed add-ons section, choose Adobe XD for Jira and then click Configure.
      The Configure Adobe XD for Jira page lists enabled projects in the left pane and disabled projects in the right pane.
    3. To disable the add-on in one or more projects, select the projects in the left pane and move them to the right pane.
    4. Click Save. In the confirmation dialog box, click Disable Projects. You can view the add-on if you are part of an enabled project or have access to a Jira issue in the project.


    Moving a project from enabled to disabled list removes the Adobe XD app from the project. Any content that was added using this integration can be restored by moving the project back to the Enabled list. 

You can attach the following types of Adobe XD links to a Jira issue:

  • Prototypes.
  • Design specs.
  • Password protected prototypes or design specs.
  • Private prototype or design spec.

To learn how to create a public or private web link to a prototype or design spec in Adobe XD, see Share prototypes and design specs.

  1. Open the Jira issue.

  2. Navigate to the Adobe XD section below the issue description.

    Adobe XD section in a Jira issue
    Adobe XD section in a Jira issue

    If you don't see the Adobe XD section, click the options menu (...) below the issue summary and choose Adobe XD.

    Choose Adobe XD section from the Options menu

  3. Paste the link to the prototype or design spec in the XD input field, and click Attach. To attach more prototypes or design specs, repeat the process.

    Paste a link to XD prototype or design specification

    A preview of the corresponding asset is displayed as a card. You can also add a short description to the asset in the card.

    For a private or password protected asset, the preview is not displayed in the card. To see the asset, click View Prototype or View Design Specs in the card. Enter the password in the XD asset view page, and then click View.

    A prototype
    A prototype

    A private or password protected design spec or a prototype
    A private or password protected design spec or a prototype

    The latest attached assets are displayed at the top. Any changes made to the attached assets in Adobe XD app are automatically reflected in the Jira issue.

By default, all the projects within the workspace are enabled to show the app within Jira issue. However, as an admin, you can choose to enable the app only for specific projects and for specific issue types. To change the default configuration, do the following:

  1. Click Manage add-ons page from the sidebar.

  2. Under User-installed add-ons section, click Adobe XD for Jira and select Configure. The Configure Adobe XD for Jira page lists your Jira projects in the left pane and your issue types in the right pane. 

    Configure Adobe XD for Jira
    Configure Adobe XD for Jira

  3. By default, the app is enabled on all the projects. To disable the app in one or more projects, select the required projects and set your preferences.

  4. By default, the app is enabled in all issue types except bugs. To disable the app in issue types, deselect the required issue types and set your preferences.

  5. Click Save.

  6. You can view the app only if you are a part of an enabled project and issue type. You can also view the app if you have access to a Jira issue type in the project.    

The latest update to the Adobe XD for JIRA Server and Datacenter app provides more information on the prototypes and design specifications.

The prototypes or design specifications attached to a Jira ticket display the following information:

Comments: When you share a link of a prototype artboard or a design specification, all the comments for that artboard are displayed in the comments section in Jira. However, when you share the link of the Home artboard of a prototype or a design specification, the total number of comments added to the prototype or a design specification are displayed.

  • Artboards: The number of artboards that are present in the prototype or design specification that are shared using XD for Jira app.
  • Views: Adobe XD for Jira app displays the names and the profile icons of all the people who have viewed the prototype through XD for Jira app. You can easily identify whether the required stakeholders have opened the XD prototypes and design specifications.

The views on the attached prototype and design specification on Jira do not include the users who have viewed the prototype from any source other than XD for Jira app.

  • Date and Time: You can view the date and the time when the prototype or a design specification was shared on a Jira issue.
  • Rich in context preview: By clicking the expand icon, you can view all the artboards in a prototype in a full screen on Jira. You can avoid switching to, making it easier for you to identify the XD files that you want to open without quitting Jira.
Label on an updated prototype or design spec
Label on an updated prototype or design spec

A. Total number of artboards B. Rich in context preview C. Unique viewers of XD link from Jira D. Total number of comments E. Date and time  F. Updated label 

  • Update Label: When a prototype or a design specification shared through XD for Jira app is updated using XD application, you see a small tag above the thumbnail in Jira. This tag indicates that the prototype or Jira specification has been updated. You can view the label if you are, or had been following the Jira issue before the XD link was shared on XD for Jira app following a ticket under any of the following criteria:
  1. You commented on the Jira issue or your name has been @ mentioned on the Jira issue where the link to XD prototype or a design specification has been shared.
  2. The ticket has been assigned to you.
  3. You are watching the ticket.
  4. You have reported the ticket.
  5. ·You shared the XD link on XD for Jira app

To use all the features of the app in Jira’s next gen project type you are supposed to be a member of that project.

  • The app now supports Jira Cloud, Jira Server, and Jira Datacenter. For Jira Server and Datacenter, the supported versions are from Jira Server 7.0.0 to v8.22.6.
  • The Jira Server app requires Internet access to reach Adobe servers. If your organization uses Jira Server and Datacenter, and has a firewall or any network restrictions, you must whitelist,,, and web addresses, and allow secure outgoing web traffic to these web addresses.
  • Adobe XD for Jira supports Japanese, German, French, Brazilian, Portuguese, Spanish, Korean, and Chinese Simplified languages for both Jira cloud and Jira server/datacenter.


Get help faster and easier

New user?

Adobe MAX 2024

Adobe MAX
The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX 2024

Adobe MAX
The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online