Connecting GitHub

Connecting GitHub

Link your GitHub account and repositories to enable automated PR creation.

Why Connect GitHub?

Connecting your GitHub account is what transforms Align from an analysis tool into an automation platform. Once connected, Align can push code fixes directly to your repository as pull requests. Instead of manually copying suggested changes, you select the issues you want to fix, click a button, and Align's AI agent opens a PR with the exact code changes needed.

The GitHub integration enables several features across the platform:

  • Automated PR creation — Fix SEO issues with a single click.
  • PR status tracking — See open, merged, and closed PRs in your dashboard.
  • Impact reports — Track how merged PRs affect your SEO and keyword rankings.
  • Weekly action plans — Get prioritized fix suggestions that map to specific code changes.
Note
PR creation requires the Agency plan ($149/mo). You can connect GitHub on any plan, but automated PR generation is an Agency-tier feature.

Connecting Your Account

To connect your GitHub account, navigate to Settings in the dashboard and click Connect GitHub. You'll be redirected to GitHub's OAuth authorization page. Review the permissions Align is requesting, then click Authorize.

After authorization, you'll be redirected back to the Align dashboard. Your GitHub username will appear in the settings panel, confirming the connection is active.

Tip
If you signed up for Align using GitHub OAuth, your account is already connected. You can skip this step and go straight to installing the GitHub App.

Installing the GitHub App

After connecting your account, you need to install the Align GitHub App on the repositories you want to work with. Click Install GitHub App in the settings panel. GitHub will prompt you to choose which repositories the app can access.

You can grant access to all repositories or select specific ones. Align only reads and writes to the repositories you explicitly link to your sites in the dashboard.

Warning
You must have write access to the repository for Align to create pull requests. If you're working with an organization repository, make sure an admin has approved the app installation.

Linking a Repository to Your Site

Once the GitHub App is installed, go back to your site in the Align dashboard. In the left panel under the site selector, you'll see a Repository section. Click Link Repository and select the repository that contains your website's source code from the dropdown.

After linking, you'll also need to set a target branch. This is the branch Align will open pull requests against.

Tip
The target branch defaults to main. Change this if your project uses a different default branch like master or develop.

Configuring the Agent

After linking a repository, you can configure the AI agent's behavior from the site settings:

  • Pause / Resume — Temporarily disable PR creation without disconnecting the repository.
  • Target branch — Change the branch that PRs are opened against at any time.
  • Disconnect — Unlink the repository from this site entirely. This does not remove the GitHub App from your account.

If you need to revoke Align's access completely, visit your GitHub settings under Applications > Installed GitHub Apps and remove the Align app.

Next Steps

Now that GitHub is connected, you're ready to automate fixes: