Troubleshooting & FAQs

Permissions required

Repo-based projects
    If the repo is owned by an individual user, known as the owner, you need to authenticate with the repo owner.
    If the repo is owned by an organisation, you need to authenticate with a user that is an admin of the repo.
Organisation-based projects
    You must be an owner within the organisation. GitHub allows you to have multiple owners of a single organisation.
Please note that you may need to explicitly grant Avion access to the organisation, as shown above. If you forget this or want to check that Avion has the correct privileges, you can navigate to and select Avion. On this screen you can verify this or grant privileges if you missed it the first time around:

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:

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 organisation

If you previously sync up Avion to GitHub, but want to add a new integration for another story map with an organisation 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 organisation 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 organisation projects, as you can define different release plans and compare these plans beside each other.

Where is my repo/organisation 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 organisation
    Ensure that you are an owner of the organisation, if you want to sync with an organisation project
    Ensure that there is a project with columns in the repo or organisation

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 organisation-based projects.
Last modified 6mo ago