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
  1. Docs
  2. Integrations
  3. Backlog tools
  4. Set up an integration

Backbone syncing

Understand how you can sync your Avion backbone to epics and other elements in your backlog tool.

Last updated 1 year ago

As a reminder, the backbone is a collective term for your . Some of our integrations allow you to sync the backbone, or certain parts of it to elements in your backlog tool.

Not all integrations support backbone syncing and those that do, have specific options to understand. Here is a table to outline the options available.

Tool
Options
Notes

Jira Cloud / Data Center

Journeys → Epics

— OR —

Steps → Epics

— OR —

Journeys → Custom Fields

— OR —

Steps → Custom Fields

It's also possible to map one layer to epics, and the other to custom fields. Example: Journeys → Epics, Steps → Custom Fields. All setups are optional and you can skip backbone syncing if desired.

Azure DevOps

Journeys → Epics — AND — Steps → Features

This is optional and you can skip backbone syncing if desired.

Trello

Journeys & Steps → Custom Fields

This is optional and you can skip backbone syncing if desired. Be aware that if you choose to sync the backbone, you are also opting in to sync story sizes to a custom field.

GitHub & ZenHub

N/A

Backbone syncing is not supported.

There are pros and cons to syncing the backbone.

Pros

  • Track the user experience all the way through to delivery

  • Allow developers to see the greater product context at all times

  • Ensure structural consistency between Avion and your backlog tool

Cons

  • A true experience-led approach doesn't always map well to "epics" or "features" in other tools

  • Most backlog tools allow elements to become "complete". This goes against the

  • Syncing the backbone closes the opportunity to use epics in other tools for better suited groupings — for instance using epics as a technical grouping of stories

šŸ¤
journeys and steps
Avion backbone ethos