Avion Knowledge Base
avion.ioSign inSign up
  • 👋Introduction
  • 👉Getting started
    • What is Avion?
    • Define your product backbone
    • Scoping and prioritizing your product
    • Creating your release plan
    • Aligning the team
    • Integrating with backlog tools
  • Docs
    • 👏Core concepts
      • Projects
        • Project team
        • Migrating to projects
      • Organizations
        • Invite a member
        • Remove a member
        • Roles
        • Transfer ownership
        • Configure your path
        • Delete your organization
    • 🚀Story map
      • Story map anatomy
      • Journeys and steps
      • Stories
      • Releases
      • Attachments
      • Tags
      • Personas
      • Labels
      • Dependencies
      • Search and filter
      • Sharing
        • Restricted links
        • Public links
      • Workflow
      • Importing data
        • Import from Excel
          • XLSX import template
        • Import from StoriesOnBoard
      • Exporting data
        • Export to PDF
        • Export to image
        • Export to CSV
        • Export to Excel
      • Rich text editor
        • Keyboard shortcuts
        • Known limitations
      • Keyboard shortcuts
      • Tips
    • 🤝Integrations
      • Backlog tools
        • Set up an integration
          • Authentication
          • Project / board selection
          • Backbone syncing
          • Map story states
          • Additional syncing options
          • Importing data
        • Sync data
          • Pushing
          • Importing
          • Attachments
          • Deleting data
        • Configuration
        • Pause an integration
        • Re-authenticate
        • Remove an integration
        • Maintenance
          • Removing stale webhooks
        • FAQs and troubleshooting
        • Services
          • Jira Cloud
            • Features
            • Set up
            • Permissions required
            • Mapping options
              • Mapping fix versions
            • Epics ~ our thoughts
            • Additional data syncing
              • Mapping custom fields
                • Company-managed projects
                • Team-managed projects
            • Migrating to epic hierarchies
            • Import using JQL
            • FAQs and troubleshooting
              • Required fields
              • Verify webhooks
              • JQL import issues
              • Workflow issues
              • Ghost cards (cards with a dashed border)
              • Limitations
              • Jira Cloud or Jira Server
          • Jira Data Center (Server)
            • Features
            • Set up
              • Creating an application link
            • Permissions required
            • Mapping options
            • Additional data syncing
              • Mapping custom fields
            • Import using JQL
            • FAQs and troubleshooting
              • Required fields
              • Ghost cards (card with a dashed border)
              • Jira Cloud or Jira Server
              • JQL import issues
          • Azure DevOps
            • Features
            • Set up
            • Permissions required
            • Import using WIQL
            • FAQs and troubleshooting
              • Verify webhooks
              • No Azure DevOps accounts were found for your user
              • Problems communicating with Azure DevOps
              • Work items couldn't be imported
              • Show epics in Azure DevOps backlog
              • Import limits
          • Trello
            • Features
            • Set up
            • FAQs and troubleshooting
          • GitHub
            • Features
            • Set up
            • Permissions required
            • FAQs and troubleshooting
              • What types of GitHub Projects are supported?
          • Linear
            • Features
            • Set up
            • Permissions required
            • FAQs and troubleshooting
      • Notifications
        • Slack
          • Set up
          • Configure notification settings
          • Remove Slack
      • Design tools and media
        • Figma
        • Adobe XD
        • Axure
        • Framer X
        • Invision Web & Studio
        • YouTube & Vimeo
      • Embed Avion
        • Confluence
        • Confluence Server
        • Notion
        • Coda
    • 🔒Security
      • Single Sign-On (SSO)
        • Setup & Configure SSO
        • Azure AD
        • Google Workspace
        • Okta
        • OpenID Connect
      • Two-factor authentication (2FA)
    • ❓FAQs
      • Attachment file types
    • 💳Billing
      • Plans and pricing
      • Legacy plans
      • Free trials
      • Billing and payments
      • Change your plan
      • Cancel your plan
      • Refunds
      • Startup, student and educational discount
  • Story Mapping Guides
    • How To Story Map — A Simple Example
    • Advantages of Story Mapping
    • A Recommended Workflow
Powered by GitBook
On this page
  • Single Issue Update Method
  • Bulk Update Method
  1. Docs
  2. Integrations
  3. Backlog tools
  4. Services
  5. Jira Cloud

Migrating to epic hierarchies

If you created your Jira Cloud integration after 13th October 2020, you do not need to follow this guide 🙂

When we first created our integration with Jira Cloud, the APIs to utilise the correct epic hierarchies (epic as a parent of task) were not available. Atlassian have since released these APIs and we have updated Avion's behaviour to use them.

However, there is a manual migration that you will need to perform if:

  • You have an active Avion integration with Jira

  • You have a story map synced to a next-gen project

  • You created the integration before 13th October 2020

  • You have Jira epics mapped to either Avion releases, steps or journeys

If your story map meets the above criteria, please follow the instructions below. There are two ways to perform the migration — to each single issue, or using Jira's bulk update function. The method you use should depend on how many issues you need to update. We suggest you read both and then decide which method is preferred.

Single Issue Update Method

If you don't have many stories to change (less than 15, perhaps), you might find it easy to just update each story individually:

  • Open each synced story in Avion and click the View in Jira link

  • Update the issue's epic to match the Avion parent that is mapped to Jira epics

  • Remove the linked issue

Bulk Update Method

1) Identify your epic mapping in Avion by navigating to Integrations → Configuration panel:

2) For each story that is synced inside Avion, we need to remove the issue link and add an epic link in Jira. This can be done in bulk, per-epic. For instance:

All three stories above are synced to Jira. I can tell this as they have a small sync icon in the bottom right corner and have a Jira key. I therefore need to update these three stories (NGNG-269, NGNG-268, NGNG-264) to have the epic NGNG-265.

3) Navigate to your project in Jira, and click Filters → Advanced Issue Search:

4) Write a query to search for all the stories in the identified type in Avion. In my case, I would need to edit three stories, so I can use the following query and press enter:

5) Click the three dots at the top right of the screen and select Bulk change all X issue(s)

6) Follow the prompts to bulk "edit" the issues and change the parent. In my case:

7) Finally, you need to remove the leftover issue link on each issue. Jira does not allow you to do this in bulk, so you can just open each issue and remove the relevant issue link:

Please note that this process needs to be carried out per-epic. If you have three Avion steps mapped to three Jira epics, you will need to bulk update three sets of issues.

Once you are done, the migration is complete. From this point, Avion will keep the epics in sync for you! 🙌

Last updated 2 years ago

🤝
You can see above that I have Jira epics mapped to Avion steps