JCMA export does not properly URL encode braces in issue description links causing malformed URLs

XMLWordPrintable

    • 1
    • Severity 3 - Minor

      Issue Summary

      When migrating Jira issues from Jira Server/Data Center to Jira Cloud using JCMA, URLs in issue descriptions that contain braces (e.g., SharePoint document links with GUIDs) may not work correctly after migration.

      Jira DC automatically escapes special characters like { when saving wiki-formatted text. During JCMA migration, these escaped characters within URLs should be properly URL-encoded, but currently they may not be processed correctly, resulting in broken links in the migrated Cloud site.

      This issue is particularly common with:

      • SharePoint document URLs that include sourcedoc={GUID} parameters
      • API URLs with JSON-style query parameters containing braces
      • Any URL where braces are part of the query string or path

      Steps to Reproduce

      1. On Jira Server/Data Center (source)
            1. Create a new issue (or use an existing one) in any project.
            2. Edit the issue description and add a URL containing braces, for example:

      Please review: https://sharepoint.example.com/Document.aspx?sourcedoc=\{5b7dbc65-56e5-433c-a1a0-df9b9938e5ad}

            3. Save the issue
            4. Verify the link works correctly in Jira DC (clicking it should navigate to the URL properly).

      2. Run JCMA Migration
            1. In JCMA, create a migration plan that includes the project containing the issue with the URL.
            2. Run the migration to Jira Cloud.
            3. Wait for the migration to complete successfully.

      3. Verify in Jira Cloud
            1. Navigate to the migrated issue in your Jira Cloud site.
            2. View the issue description.
            3. Click on the URL in the description.

      Expected Results

      After JCMA migration:

      • URLs in issue descriptions should work correctly when clicke
      • SharePoint links, API URLs, and other URLs containing braces should navigate to the correct destination.
      • The links should be properly formatted and URL-encoded so they are recognized as valid URLs by browsers and external systems.

      For example, a SharePoint URL like:

      https://sharepoint.example.com/Document.aspx?sourcedoc=\{5b7dbc65-56e5-433c-a1a0-df9b9938e5ad}

      Should remain clickable and functional after migration.

      Actual Results

      After JCMA migration of issues containing URLs with braces:

      • Some URLs may not work when clicked in Jira Cloud.
      • The links may appear broken or malformed.

      Workaround

      Until this issue is resolved, if you have a large number of issues with URLs containing braces:

      1. Contact Atlassian Support before running your migration.
      2. Support can help assess the scope of the issue in your instance.
      3. They may be able to provide guidance on the best approach for your specific situation.

            Assignee:
            Unassigned
            Reporter:
            Nicolas Ferreira
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated: