Skip to content
Deployify Docs

Connecting GitHub

Overview

Section titled “Overview”

Deployify integrates with GitHub to track your theme code changes and automatically deploy them to Shopify.

Prerequisites

Section titled “Prerequisites”
  • A GitHub account
  • A repository containing your Shopify theme code
  • Owner or admin access to the repository (or organization)

Step-by-Step Guide

Section titled “Step-by-Step Guide”

1. Open the Repositories Page

Section titled “1. Open the Repositories Page”

In the Deployify app:

  1. Click Repositories in the left sidebar
  2. Click “Connect GitHub”

2. Install the GitHub App

Section titled “2. Install the GitHub App”

You’ll be redirected to GitHub to install the Deployify GitHub App:

  1. Select repositories

    • Choose “All repositories” (recommended for agencies)
    • Or select specific repositories

  2. Review permissions

    • Contents (read) — to read your theme files
    • Metadata (read) — to list repositories
    • Secrets (read/write) — for GitHub Actions secrets

  3. Click “Install”

3. Select Your Repository

Section titled “3. Select Your Repository”

After installation:

  1. You’ll return to Deployify
  2. Select the repository you want to use from the dropdown
  3. Click “Save Repository”

What happens after connection?

Section titled “What happens after connection?”
  • Deployify receives webhooks for pushes to your configured branch
  • You can now create workflows that deploy from this repository
  • The GitHub App is automatically configured with necessary secrets

Repository Requirements

Section titled “Repository Requirements”

Your repository should follow standard Shopify theme structure:

Terminal window
my-theme/
├── assets/
├── config/
├── layout/
├── locales/
├── sections/
├── snippets/
└── templates/

Troubleshooting

Section titled “Troubleshooting”

“No repositories found”

  • Ensure the GitHub App is installed on the correct organization/account
  • Try reinstalling the GitHub App

“Installation failed” or permission errors

  • You must be an owner or have admin access to install GitHub Apps
  • For organization repos, ask an organization owner to install the app

“Repository already connected”

  • Each repository can only be connected to one Deployify tenant
  • Contact support to transfer ownership if needed

Managing Multiple Repositories

Section titled “Managing Multiple Repositories”
Plan Max Repositories
Free 1
Starter 3
Growth 10
Scale 25

Security Notes

Section titled “Security Notes”
  • Your GitHub access tokens are encrypted at rest
  • We only read theme files, never modify your repository code
  • Webhooks are validated using HMAC signatures
  • You can revoke access anytime from GitHub Settings → Applications