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
  • Organization is not appearing in Avion
  • What Happens When I...
  • Avoiding milestone name clashes
  • Importing closed issues
  • Adding a new organization
  • Syncing a GitHub project to multiple Avion story maps
  • Where is my repo/organization in the list?
  • Are GitHub's milestones supported?
  • Can I push user stories to multiple/different repos?
  • Labels not syncing
  1. Docs
  2. Integrations
  3. Backlog tools
  4. Services
  5. GitHub

FAQs and troubleshooting

Last updated 1 year ago

Organization is not appearing in Avion

GitHub has added an additional layer of security for Organizations. You need to open up access in the Organization settings:

What Happens When I...

Action

Result

Update story

We will be update the issue where applicable, assuming that the story has been pushed or imported

Delete story

We will close the issue

Update release name

We will update the milestone name. Only applies to repo projects

Archive release

Nothing will happen in GitHub

Delete a release

The milestone and issues will be deleted in Github

Update story state

We will update the project card column according to what is mapped in Avion

Action

Result

Delete issue

If the story has been pushed to GitHub, we will unsync the story and it will remain in Avion. Feel free to delete it from Avion if you don't need it

Delete project card

If the story has been pushed to GitHub, we will unsync the story and it will remain in Avion. Feel free to delete it from Avion if you don't need it. The issue will remain in GitHub

Close issue

Nothing will happen in Avion

Delete milestone

If a release exists in Avion for the milestone, all synced stories will be moved to unplanned. The release will not be deleted, but will be unsynced (still in Avion). Only applies to repo projects

Archive project card

Nothing will happen in Avion

Close milestone

Nothing will happen in Avion. Only applies to repo projects

Update issue

If the story has been pushed to GitHub, we will update the story in Avion

Update issue size label

We will attempt to update the size in Avion

Remove issue from milestone

We will move the story to the Unplanned release in Avion. Only applies to repo projects

Change issue's milestone

We will attempt to update the story with the corresponding release in Avion. Only applies to repo projects

Change project card's column

We will update the status of the story in Avion inline with your state mappings

Update milestone name

We will attempt to update the corresponding release's name in Avion. Only applies to repo projects

Transfer issue to another repo

We will unsync the issue, but the story will remain in Avion

Delete repo

If you have synced to a repo-based project, we will remove the integration. If you have synced to an organisation-based project, we will update the list of repos in Avion and unsync any stories that came from that repo

Avoiding milestone name clashes

When synced to a repo-based project, you cannot use the same name for two Avion releases and push them, as GitHub has a clash restriction on milestone names.

Importing closed issues

Please note that we do not import closed issues or milestones. To import open issues, please ensure that there is a project card associated with the issue. To import open milestones, please ensure there is at least one issue in the milestone.

Adding a new organization

Syncing a GitHub project to multiple Avion story maps

This is supported in Avion. It can be a useful way to visualise different user journey setups. In particular, this works well with organization projects, as you can define different release plans and compare these plans beside each other.

Where is my repo/organization in the list?

  • Ensure that you are an owner of the repo

  • Ensure that you are an admin of the repo, if the repo is owned by an organization

  • Ensure that you are an owner of the organization, if you want to sync with an organization project

  • Ensure that there is a project with columns in the repo or organization

Are GitHub's milestones supported?

No, Avion does not use GitHub milestones

Can I push user stories to multiple/different repos?

Yes, each story will have a repo dropdown where you can select the target repo for the underlying issue.

Labels not syncing

if you have optionally selected to sync Avion tags or releases to labels and are using the all-new project experience, labels should sync automatically, whichever tool you update them in. There is one exception. If you edit a label from the GitHub project item page, Avion will not update. This is a shortcoming with GitHub's webhooks. To avoid this data sync issue, update labels from the issue screen in GitHub, or from Avion.

If you previously sync up Avion to GitHub, but want to add a new integration for another story map with an organization that is not getting recognised, you may need to grant privileges to Avion. You can do this by going to when signed in as the user in question and granting the appropriate organization by clicking Grant:

🤝
https://github.com/settings/applications