--- title: Using Your Azure DevOps Integration description: Integrate ProductPlan with Jira to better connect your strategic roadmap to your specific project details that are being planned and tracked in Jira. --- [Skip to content](https://support.productplan.com/ado-integration-overview-v2#main-content) English Show submenu for translations [![ProductPlan\_Logo\_Positive 1](https://support.productplan.com/hubfs/ProductPlan_Logo_Positive%201.svg)](https://www.productplan.com/) Open main navigation Close main navigation - English Show submenu for translations - [https://www.productplan.com/](https://www.productplan.com/) [https://www.productplan.com/](https://www.productplan.com/) Find best practices and answers to common questions in ProductPlan - There are no suggestions because the search field is empty. 1. [Support Center](https://support.productplan.com/?hsLang=en) 2. [Roadmapping](https://support.productplan.com/roadmapping?hsLang=en) 3. [Integrations](https://support.productplan.com/roadmapping?hsLang=en#integrations) # Using Your Azure DevOps Integration ## Learn how to use ProductPlan's Azure DevOps integration.   [**Overview**](https://support.productplan.com/ado-integration-overview-v2#overview) [**User Authorization**](https://support.productplan.com/ado-integration-overview-v2#user-authorization) **[Working with Integrated Items in the Product Backlog](https://support.productplan.com/ado-integration-overview-v2#backlog)** [**Adding Integrated Items to Your Roadmap**](https://support.productplan.com/ado-integration-overview-v2#adding-roadmap) **[Pushing a New Item to Azure DevOps](https://support.productplan.com/ado-integration-overview-v2#push-new-item)**   ### **Overview** ProductPlan's Azure DevOps integration allows you to connect your Azure DevOps project information with your roadmap. You can import your Azure DevOps epics, features, and stories directly into your product backlog to place on your roadmap views. The integration is real-time, so updates are automatically reflected to keep Azure DevOps and ProductPlan in sync with one another. An Account Admin will configure the integration for the account, including choosing which Azure DevOps projects to sync from, and establishing the field mappings for each project. Please see Setting Up Your Azure DevOps Integration for setup instructions.   ### **User Authorization** Once an Account Admin configures the integration for the account, users will need to complete a one-time authorization to their individual Azure DevOps connection in order to push updates from ProductPlan to Azure DevOps. This ensures changes made in Azure DevOps through a bi-directional field are attributed to the correct individual. 1. The system will prompt you to authorize your Azure DevOps connection the first time you make a change to a bi-directional field or push an item to Azure Dev Ops. Click the Authorize button. ![](https://support.productplan.com/hs-fs/hubfs/image-png-Oct-20-2026-09-45-30-3745-PM.png?width=2488&height=1412&name=image-png-Oct-20-2026-09-45-30-3745-PM.png) 2. Select your account in the dropdown field, then click Accept. ![](https://support.productplan.com/hs-fs/hubfs/image-png-Oct-20-2026-09-46-06-5464-PM.png?width=350&height=420&name=image-png-Oct-20-2026-09-46-06-5464-PM.png) 3. Click the "Click to try again" link next to the field to initiate pushing the updated value to Azure DevOps. Any future updates you make to bi-directional fields should now successfully push to Azure DevOps. ![](https://support.productplan.com/hs-fs/hubfs/image-png-Oct-20-2026-09-46-43-4452-PM.png?width=1740&height=1438&name=image-png-Oct-20-2026-09-46-43-4452-PM.png) ### **Working with Integrated Items in the Product Backlog** 1. First, an Account Admin will need to set up a saved Azure DevOps query to import work items from your Azure DevOps projects as initiatives, epics, and stories in your product backlog. Please see [Product Settings | Azure DevOps Integration Import](https://support.productplan.com/roadmap-data-source-import-ado?hsLang=en) for instructions to complete this step. 2. Once your Azure DevOps information has been imported, click on the Backlog tab in the navigation menu to access the backlog. Keep in mind that the backlog is scoped to the product that you are currently operating in. You can use the Product Switcher at the top of the navigation menu to switch to a different product, if you have access to more than one product. ![](https://support.productplan.com/hs-fs/hubfs/image-png-Sep-30-2026-09-09-06-1581-PM.png?width=670&height=386&name=image-png-Sep-30-2026-09-09-06-1581-PM.png) 3. Click into an integrated initiative, epic, or story to open the details drawer. Integrated fields will be indicated with a plug icon. - Fields that sync one-way from Azure DevOps to ProductPlan are not editable, and will be updated according to the corresponding mapped field in Azure DevOps. - Fields that are enabled for two-way syncing are editable. If you make a change to the field in ProductPlan, the update will automatically push to Azure DevOps in real-time. ![](https://support.productplan.com/hs-fs/hubfs/image-png-Sep-30-2026-09-13-03-1022-PM.png?width=670&height=609&name=image-png-Sep-30-2026-09-13-03-1022-PM.png) ### **Adding Integrated Items to Your Roadmap** Whether you are creating a new roadmap, or adding content to an existing roadmap, you can easily place initiatives, epics, and stories from your product backlog onto your roadmap.   1. Click the Backlog Items tab on the right-hand side of your roadmap to open the Backlog Items drawer. The drawer will display any initiatives, epics, or stories currently in your product backlog that are not present on the roadmap view.  ![](https://support.productplan.com/hs-fs/hubfs/image-png-Sep-30-2026-09-21-55-9978-PM.png?width=670&height=380&name=image-png-Sep-30-2026-09-21-55-9978-PM.png) 2. Drag and drop the items onto your roadmap to add them to the view. The Backlog Items drawer will automatically display new items that are imported into the backlog through the Azure DevOps integration. **![](https://support.productplan.com/hs-fs/hubfs/image-png-Sep-30-2026-09-23-49-7493-PM.png?width=670&height=411&name=image-png-Sep-30-2026-09-23-49-7493-PM.png)** 3. To view the details of an integrated item, or to update its information, click on the initiative, epic, or story directly on your roadmap to open the details drawer. The details drawer experience is the same experience as accessing it from the backlog.  ![](https://support.productplan.com/hs-fs/hubfs/image-png-Sep-30-2026-09-27-54-6496-PM.png?width=670&height=404&name=image-png-Sep-30-2026-09-27-54-6496-PM.png) 4. A link back to the corresponding Azure DevOps item is located in the Integrations tab. ![](https://support.productplan.com/hs-fs/hubfs/image-png-Oct-20-2026-09-48-00-7939-PM.png?width=884&height=494&name=image-png-Oct-20-2026-09-48-00-7939-PM.png)   ### **Pushing a New Item from ProductPlan to Azure DevOps** You can push a new item into Azure DevOps from an existing initiative, epic, or story in ProductPlan. Pushing a new item is an intentional action, and can be done through the following steps. 1. Click into the initiative, epic, or story. 2. Click on the Integrations tab. 3. Click Push Work Item. ![](https://support.productplan.com/hs-fs/hubfs/image-png-Oct-20-2026-09-49-15-1952-PM.png?width=886&height=492&name=image-png-Oct-20-2026-09-49-15-1952-PM.png) 4. Select the Azure DevOps project the item should be created in. 5. Select the work item type. 6. Review the summary and adjust if needed. 7. Click Sync to Azure DevOps. 8. The item will be pushed to Azure DevOps, and will be synchronized going forward. ![](https://support.productplan.com/hs-fs/hubfs/image-png-Oct-20-2026-09-50-04-2552-PM.png?width=484&height=452&name=image-png-Oct-20-2026-09-50-04-2552-PM.png)        - [Platform Updates & Events](https://support.productplan.com/platform-updates-events?hsLang=en#main-content) - [Product Updates](https://support.productplan.com/platform-updates-events?hsLang=en#product-updates) - [Webinars + Trainings](https://support.productplan.com/platform-updates-events?hsLang=en#webinars-trainings) - [Product Intelligence](https://support.productplan.com/product-intelligence?hsLang=en#main-content) - [Products](https://support.productplan.com/product-intelligence?hsLang=en#products) - [Research Surveys + Feedback Forms](https://support.productplan.com/product-intelligence?hsLang=en#research-surveys-feedback-forms) - [Ideas + Signals](https://support.productplan.com/product-intelligence?hsLang=en#ideas-signals) - [Strategy](https://support.productplan.com/strategy?hsLang=en#main-content) - [Objectives & Key Results](https://support.productplan.com/strategy?hsLang=en#objectives-key-results) - [Video Guides](https://support.productplan.com/strategy?hsLang=en#video-guides) - [\[Legacy\] Roadmapping](https://support.productplan.com/legacy-roadmapping?hsLang=en#main-content) - [Getting Started](https://support.productplan.com/legacy-roadmapping?hsLang=en#getting-started) - [Integrations](https://support.productplan.com/legacy-roadmapping?hsLang=en#integrations) - [Standardization](https://support.productplan.com/legacy-roadmapping?hsLang=en#standardization) - [Roadmap Features](https://support.productplan.com/legacy-roadmapping?hsLang=en#roadmap-features) - [Strategic Portfolio](https://support.productplan.com/legacy-roadmapping?hsLang=en#strategic-portfolio) - [Sharing](https://support.productplan.com/legacy-roadmapping?hsLang=en#sharing) - [Frequently Asked Questions](https://support.productplan.com/legacy-roadmapping?hsLang=en#frequently-asked-questions) - [Roadmapping](https://support.productplan.com/roadmapping?hsLang=en#main-content) - [Integrations](https://support.productplan.com/roadmapping?hsLang=en#integrations) - [Launch](https://support.productplan.com/launch?hsLang=en#main-content) - [Video Guides](https://support.productplan.com/launch?hsLang=en#video-guides) - [Initiatives](https://support.productplan.com/initiatives?hsLang=en) - [Account Setup & Security Settings](https://support.productplan.com/account-setup-security-settings?hsLang=en#main-content) - [Getting Started](https://support.productplan.com/account-setup-security-settings?hsLang=en#getting-started) - [Single Sign On](https://support.productplan.com/account-setup-security-settings?hsLang=en#single-sign-on) - [User Permissions](https://support.productplan.com/account-setup-security-settings?hsLang=en#user-permissions) - [Notifications](https://support.productplan.com/account-setup-security-settings?hsLang=en#notifications) - [AI](https://support.productplan.com/account-setup-security-settings?hsLang=en#ai) - [Licenses + Payment](https://support.productplan.com/account-setup-security-settings?hsLang=en#licenses-payment) - [Security + Privacy](https://support.productplan.com/account-setup-security-settings?hsLang=en#security-privacy) - [FAQ](https://support.productplan.com/faq?hsLang=en) [![ProductPlan\_Logo](https://support.productplan.com/hubfs/ProductPlan_Logo_Negative%201.svg "ProductPlan_Logo")](https://support.productplan.com/?hsLang=en) Copyright © 2026, ProductPlan