[#65583] We have published a dedicated working document on migrating …

docs/faq/README.md

@@ -270,17 +270,9 @@ You can use the first two steps of [this instruction](../installation-and-operat
 
 To migrate from Bitnami **to Enterprise on-premises** please use [this instruction](../installation-and-operations/installation-faq/#how-can-i-migrate-from-bitnami-to-the-official-openproject-installation-packages). We offer (paid) installation support to help you migrate to OpenProject (for the Enterprise on-premises edition). Please contact us to request it.
 
-### How can I migrate from Jira/Confluence to OpenProject?
+### How can I migrate from JIRA/Confluence to OpenProject?
 
-At the moment there are these ways to migrate:
-
-- our [API](../api/)
-- our [Excel sync](../system-admin-guide/integrations/excel-synchronization)
-- Using a [Markdown export app](https://marketplace.atlassian.com/apps/1221351/markdown-exporter-for-confluence) you can export pages from Confluence and paste them (via copy & paste) into OpenProject in e.g. the wiki. This should preserve at least most of the layout. Attachments would then have to be added manually.
-
-Our partners at [ALMToolbox](https://www.almtoolbox.com/)  are happy to support you with Jira or Confluence migration. 
-
-For more information please contact us.
+Please consult [JIRA migration overview page](../installation-and-operations/jira-migration/) for an overview of all existing options.
 
 ### How can I migrate from Community edition or Enterprise on-premises to Enterprise cloud?
 

docs/installation-and-operations/jira-migration/README.md

@@ -0,0 +1,101 @@
+---
+sidebar_navigation:
+  title: JIRA migration
+  priority: 90
+---
+
+# Migrating from JIRA and Confluence to OpenProject
+
+> [!NOTE]
+>
+> This page is a work in progress. The OpenProject team is actively developing an upcoming JIRA and Confluence migration tool. Information on this page may change as new migration options become available.
+>
+> Last edited on: November 11, 2025.
+
+## Overview
+
+This guide provides an overview of the current options for migrating data from Atlassian JIRA or Confluence to OpenProject. It also describes ongoing community and in-house development efforts for dedicated migration solutions.
+
+With the [end of life for JIRA Data Center](https://www.openproject.org/blog/jira-alternative-end-of-data-center/), many organizations are evaluating OpenProject as a secure, open-source, and self-hosted alternative for project management and collaboration.
+
+## Migration Options
+
+### 1. OpenProject migration tool
+
+OpenProject is developing a solution for migrating from JIRA and Confluence. You can follow the progress of OpenProject's [JIRA migration Stream](https://community.openproject.org/projects/jira-migration) and provide feedback. This tool will simplify data import for JIRA projects, including:
+
+- Issue types
+- Users and groups
+- Fields and custom fields
+- Attachments
+- Workflows
+
+> [!IMPORTANT]
+> This feature is under active development and not yet available for production use.
+
+**Contributing and data donation**
+
+To support the development of the official migration tool, we are collecting anonymized data samples. This data helps test and validate import capabilities across different JIRA and Confluence configurations.
+
+> [!TIP]
+> Please reach out to us if you want to donate your data, we will sign an NDA to ensure confidentiality.
+
+### 2. API
+
+Use the [OpenProject REST API](https://www.openproject.org/docs/api) to migrate data programmatically. This option provides full flexibility and supports most OpenProject entities, such as:
+
+- Work packages
+- Users
+- Comments
+- Attachments
+
+> [!NOTE]
+> The API-based approach requires technical expertise and scripting or integration development to map JIRA and Confluence data structures to OpenProject.
+
+### 3. Excel synchronization
+
+The [Excel synchronization integration](https://www.openproject.org/docs/system-admin-guide/integrations/excel-synchronization) allows you to import and export tabular data between JIRA, Confluence, and OpenProject using spreadsheets.
+This method is suitable for small- to medium-sized migrations and provides an opportunity to review and clean data manually before import.
+
+### 4. Confluence → Markdown → Wiki
+
+You can migrate Confluence content into OpenProject using Markdown export and manual import:
+
+1. Use a Markdown export app such as [Markdown Exporter for Confluence](https://marketplace.atlassian.com/apps/1221351/markdown-exporter-for-confluence).
+2. Copy and paste the exported Markdown into the OpenProject Wiki module.
+3. Verify formatting and structure after import.
+4. Upload attachments manually (these are not included in the Markdown export).
+
+This approach preserves most layout elements and is recommended for documentation or knowledge base content.
+
+### 5. Community-developed JIRA importer
+
+A community-developed tool, the [OpenProject JIRA Importer](https://github.com/dotnetfactory/openproject-jira-importer) provides additional import capabilities.
+It supports importing JIRA issues into OpenProject and is available as open-source software.
+
+Refer to the [JIRA migration community development blog article](https://www.openproject.org/blog/jira-migration-community-development/) for background information and usage guidance.
+
+## Recommended migration workflow
+
+### 1. Preparation
+
+- Document your existing JIRA and Confluence configuration (projects, issue types, workflows, fields, spaces).
+- Identify which data to migrate and which to archive.
+- Clean up legacy data before starting.
+
+### 2. Testing
+
+- Set up a test instance of OpenProject.
+- Migrate a small subset of data using one of the methods described above.
+- Verify field mappings, attachments, and relationships.
+
+### 3. Execution
+
+- Perform the full migration after successful testing.
+- Validate data integrity after import.
+- Recreate workflows, permissions, and boards in OpenProject as required.
+
+### 4. Post-migration
+
+- Provide training to users.
+- Archive or decommission the legacy systems if applicable.

docs/system-admin-guide/integrations/README.md

@@ -93,13 +93,16 @@ Some tools do not have a direct integration with OpenProject, but there are work
 
 Find out more about the [Excel synchronization with OpenProject](./excel-synchronization).
 
-### Jira
+### JIRA
 
-We do not provide a direct integration between OpenProject and Jira ourselves. However, you can export your tasks from Jira into an Excel file and then import these tasks via an [Excel plugin into OpenProject](./excel-synchronization).
+We do not provide a direct integration between OpenProject and Jira ourselves. 
 
-If you want to migrate from Jira to OpenProject, please consult [this user-provided OpenProject Jira importer](https://github.com/dotnetfactory/openproject-jira-importer). Please note that it is not officially supported and that we do not take any liability when you use it. 
+If you want to migrate from Jira to OpenProject, please consult [this overview page](../../installation-and-operations/jira-migration/). Please note that it is not officially supported and that we do not take any liability when you use it. 
 
-If you would like to learn more about the features of **OpenProject vs Jira** please read [here](https://www.openproject.org/blog/open-source-jira-alternative/).
+For more information, please refer to: 
+
+- [Feature comparison of OpenProject vs JIRA](https://www.openproject.org/project-management-software-alternatives/best-jira-alternative/)
+- [End of life of Atlassian Data Center](https://www.openproject.org/alternative-atlassian-jira-data-center/)
 
 ### Microsoft Project