Connecting GitHub

Overview

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

Prerequisites

• A GitHub account
• A repository containing your Shopify theme code
• Owner or admin access to the repository (or organization)

Step-by-Step Guide

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

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

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?

• 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

Your repository should follow standard Shopify theme structure:

my-theme/
├── assets/
├── config/
├── layout/
├── locales/
├── sections/
├── snippets/
├── templates/
└── .github/workflows/ (optional — we'll create this)

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

Plan	Max Repositories
Free	1
Starter	3
Growth	10
Scale	25

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