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
  • Why aren’t my stories automatically synced?
  • Can I sync to multiple projects / boards?
  • Can I hook up multiple backlog tools to a single story map?
  • If I delete in Avion, will data be deleted in my backlog tool?
  • If I delete in my backlog tool, will data be deleted in Avion?
  • I can't authenticate
  • Something is not syncing
  • Attachments aren't syncing
  • Tags aren't syncing
  • Comments / dependencies / personas aren't syncing
  • How do alias cards sync?
  • Can I push individual stories?
  1. Docs
  2. Integrations
  3. Backlog tools

FAQs and troubleshooting

Answers to common questions and possible fixes for common troubleshooting queries in relation to our backlog integrations.

Last updated 1 year ago

This page answers the general queries we receive about our backlog integrations. If you have a query specific to one integration, don't forget to check out the FAQs and troubleshooting section under the integration name from the menu on the left.

If you have any questions that are not answered on this page, please don't hesitate to email us at support@avion.io.

Why aren’t my stories automatically synced?

Once the story map is integrated, Avion won't create corresponding stories in your backlog tool until you push a release, push a story or import. More information on the .

Can I sync to multiple projects / boards?

A single story map can only be integrated with one backlog tool and one project / board at a time.

However, different story maps can have totally unique backlog integrations across multiple instances or even tools.

For example, within the same Avion organization, you could have:

  • Story map 1 ↔ Company A's Trello board 1

  • Story map 2 ↔ Company A's Trello board 2

  • Story map 3 ↔ Company B's Trello board 1

  • Story map 4 ↔ Company C's Jira project 1

But, how about the reverse? Can you set up multiple story maps that all sync with the same project / board? You can! Although there are some caveats to be aware of.

If you sync two different story maps (with different ) to the same project in Jira and import, you could inadvertently end up with story map 1's journeys and steps in story map 2. This might be your desired behaviour, but the most likely use-case here is to keep this separate across story maps.

This is possible using JQL with our Jira integration or WIQL with our Azure DevOps integration.

Can I hook up multiple backlog tools to a single story map?

No. A single story map can only be integrated to a single backlog tool.

If I delete in Avion, will data be deleted in my backlog tool?

If you delete a story that is synced to a backlog tool, you will be asked if you want to delete the story in both places or just in Avion.

Please remember that if you delete a journey, step or release that contains synced stories, this will apply to all synced stories. Deleted cards are not recoverable.

If I delete in my backlog tool, will data be deleted in Avion?

No. If you delete a synced item from your backlog tool, you will see a notification in Avion about the operation. The item will remain in Avion, but will be unsynced.

I can't authenticate

A common issue is that a popup blocker is blocking the authentication window. Please ensure that your popup blocker is disabled on the avion.io domain.

Something is not syncing

When a card is in sync, as shown above, changes to the card in either tool should stay up-to-date between Avion and the backlog tool.

Attachments aren't syncing

Tags aren't syncing

Comments / dependencies / personas aren't syncing

How do alias cards sync?

They don't! Alias cards will be ignored when you push a release, but the source card of an alias will be pushed as normal if it's included in the release that you are pushing.

Can I push individual stories?

Yes, just right-click the story and select the Push action from the menu.

Cards will only sync once they have been or have been . You can tell if a card is in sync by the sync icon on the card front:

If you are seeing errors via notifications on the story map, your authentication might have expired or your permissions may have been revoked. You can try , which may resolve the issue.

Attachment syncing needs to be enabled from the panel. Please note that attachments are the only thing that are a one-way sync. Avion will push them to your backlog tool, but attachments will not be imported, nor will we sync the deletion of attachments.

Tags syncing needs to be enabled from the panel.

Unfortunately, we don't yet sync these elements! Feel free to submit a .

🤝
pushed
imported
re-authenticating
configuration
configuration
feature request
journeys and steps
Avion workflow here