Ways to connect GitHub to Span

Last updated: October 29, 2026

Span reads GitHub through a read-only GitHub App. Which Span integration you use depends on where your GitHub lives: github.com, GitHub Enterprise Cloud with data residency, or GitHub Enterprise Server.

Why it matters

Picking the right integration up front saves a failed setup. The GitHub card works only for github.com. Enterprise tenants on ghe.com and self-hosted servers use the GitHub Enterprise card, which first creates a GitHub App on your own instance.

How it works

You have

Example domain

Span integration to use

GitHub or GitHub Enterprise hosted on github.com

github.com

GitHub

GitHub Enterprise Cloud with data residency

your-org.ghe.com

GitHub Enterprise → Deployment: Cloud (with data residency)

GitHub Enterprise Server

github.company.com

GitHub Enterprise → Deployment: Server

Not sure which you have? Look at the URL you use to view your repositories. github.com/your-org means GitHub. A ghe.com subdomain means GitHub Enterprise → Cloud (with data residency). A private hostname means GitHub Enterprise → Server.

  • GitHub (github.com): the standard integration for any organization on github.com, including a GitHub Enterprise Cloud plan hosted on github.com. There is no separate card for the Enterprise plan. The URL is what matters.

  • GitHub Enterprise (Server or Cloud with data residency): Span creates a GitHub App on your instance. The app is public on that instance, so you can install it on several organizations there.

  • GitHub Issues: a project-management source that uses the same GitHub App installation, so connect GitHub first. Use it when your team tracks work in GitHub Issues and you want issue cycle time, issue volume, and PR-to-issue links.

  • GitHub Copilot: not a separate connection. It is a toggle on an existing GitHub connection that adds Copilot seat assignments and per-user usage data. AI Code Ratio does not need it.

Setup

GitHub (github.com)

  1. Go to Settings → Integrations and click Connect on the GitHub card.

  2. Authorize Span's GitHub App and choose all or selected repositories.

  3. To add another organization, open the GitHub integration and click Connect another.

GitHub Enterprise (Server or Cloud with data residency)

  1. Go to Settings → Integrations and click Set Up on the GitHub Enterprise card.

  2. Under GitHub App Creation, choose the Deployment: Server or Cloud (with data residency).

  3. Enter the hostname only, with no https://, and the app-owner organization.

  4. Click Create GitHub App. GitHub opens in a new tab, then redirects back to Span. The status changes to Created.

  5. Click Connect and install the app on each organization Span should read.

You need the Manage Integrations permission in Span. Owners, Admins, and the Integration Admins group have it by default.

Things to know

  • Every option is read-only. Span never writes to GitHub.

  • The hostname must match the deployment you pick. A data residency hostname is always a subdomain of ghe.com. If you pick Cloud (with data residency) with github.company.com, or Server with acme.ghe.com, Span rejects the hostname and tells you to choose the other option.

  • Server instances may need a firewall rule. Span's hosted service must reach your server. Your network team may need to allow Span's outbound IPs.

  • You can mix options. For example, connect GitHub for cloud organizations and GitHub Enterprise → Server for a self-hosted instance in the same workspace.

  • Data refreshes about every 2 hours on every option.

  • Some metrics differ on GitHub Enterprise. On either deployment, PR Revert Rate reads 0 because Span detects reverts on github.com and Azure DevOps only. Est. Bug PR Density doesn't run for an organization with any GitHub Enterprise connection, even for its github.com repositories.

Related articles

Integrating GitHub with Span

GitHub Enterprise Cloud (with data residency)

GitHub Copilot Integration Guide

Network Access Requirements

Need help?

Contact your Span account team or reach out to support@span.app.