FAQs and troubleshooting

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...

In Avion

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

In GitHub

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

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 https://github.com/settings/applications when signed in as the user in question and granting the appropriate organization by clicking Grant:

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?

Yes, but only for repo-based projects.

Can I push user stories to multiple/different repos?

Yes, but only for organization-based projects or ZenHub workspace integrations.

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.