Frequently Asked Questions
Answers to common questions about using the Agile Flights app - integrations, plans and limits, accounts, and more.
Integrations
Which issue trackers does Agile Flights integrate with?
Currently, Agile Flights integrates with GitHub and JIRA Cloud. Both integrations let you search for issues directly when adding crates to a flight, so you don't have to switch tabs and copy-paste URLs. GitHub connects via a GitHub App installation, while JIRA connects via your Atlassian Cloud domain, email, and an API token. Both can be set up in Settings > Integrations by an organisation owner.
Can I use both GitHub and JIRA at the same time?
Yes. If both integrations are connected and enabled for a team, both search buttons appear side by side when adding crates. You can search GitHub for one crate and JIRA for the next - they're completely independent. Teams can also disable one and keep the other if they only use a single tracker.
Is my JIRA API token safe?
Yes. JIRA API tokens are stored server-side in an encrypted column that is never exposed to the browser. The token is only used by server-side edge functions to proxy search requests to the JIRA API. Your browser never sees, stores, or transmits the token after the initial connection.
Plans and Limits
What are the limits on each plan?
Each plan tier has limits for teams, active flights per team, team members, organisation members, and integrations. The Free plan gives you 1 team with up to 5 active flights. The Team plan bumps that to 5 teams and 25 active flights per team. Enterprise supports up to 50 teams with unlimited active flights and team members. For the full breakdown, see the Plans & Limits page.
What happens if I reach my flight limit?
The dashboard shows you exactly where you stand with an "X/Y in flight" badge next to the New Flight button. As you approach your limit the badge turns amber (at 80% capacity), and when you hit it the badge turns red and the New Flight button is disabled. You won't be able to activate new flights until you land or archive existing ones, or upgrade your plan. The same pattern applies to team limits - the "Create New Team" option is disabled when you're at your team limit.
Can I exceed limits temporarily?
No. Limits are enforced at the database level, not just in the UI. If you're at your active flight limit, neither the interface nor the API will allow a new flight to be activated. This is a deliberate design choice to keep the limits predictable and consistent. If you need more capacity, upgrade your plan - the change takes effect immediately.
What does the advisory banner mean?
When a team has 8 or more active flights, the dashboard shows a yellow advisory banner suggesting you consider splitting work across teams. This appears on every plan, including Enterprise. It's not a hard limit - just a recommendation based on the principle that too many concurrent flights reduce focus. You can dismiss the banner and it won't appear again until your next browser session.
Account & Emails
What login methods are supported?
Agile Flights supports three sign-in methods: email and password, GitHub OAuth, and Google OAuth. All three are available on the sign-in page for every user by default. If your organisation enforces SSO via a verified domain, email and password login is blocked for users on that domain - they'll need to use Google OAuth instead. For full details, see the Authentication & SSO page.
Can we require SSO for our organisation?
Yes, on the Enterprise plan. Organisation owners can verify their email domain via a DNS TXT record, then enable the "Require SSO" toggle in Settings > Authentication. Once enabled, all users with an email on the verified domain must sign in with Google OAuth - email and password login is blocked for them. Users whose email doesn't match the verified domain are unaffected.
What happens when a user joins via SSO?
When a user signs in with Google using an email that matches a verified domain with SSO enforcement enabled, they are automatically added to the organisation. This is called auto-provisioning. They join the organisation only - not any specific team. Team admins can then add them to the appropriate teams from Settings > Teams > [Team Name] > Members using the "Add Member" button.
Can I unsubscribe from onboarding emails?
Yes. Every onboarding email includes an unsubscribe link in the footer. Clicking it immediately stops the onboarding sequence. This only affects onboarding emails - you'll still receive important account notifications like team invites and password resets.