2 minutes February 26, 2026

How Can I Enable Automatic WordPress Theme Updates from a Private GitHub Repository?

Managing a custom WordPress theme for clients often means storing it in a private GitHub repository. However, manually packaging and uploading ZIP files for every update is inefficient and error-prone.

An automatic update mechanism allows your theme to behave like an official WordPress theme, delivering version updates directly inside the WordPress dashboard, securely and seamlessly.

The Problem: Manual Theme Deployment

Manually updating private themes creates several operational challenges:

Clients depend on developers for every update
Security fixes may be delayed
Version inconsistencies occur across installations
Manual ZIP uploads increase the risk of errors

Without an automated system, maintaining multiple client websites becomes time-consuming and difficult to scale.

The Solution: GitHub Update Integration

By integrating the plugin-update-checker library into your theme, you can turn your private GitHub repository into an update server.

Basic Setup Steps

Download and include the library inside your theme (for example: includes/lib/).
Add the updater configuration inside your functions.php.

/**
 * Setup automatic updates from a private GitHub repo
 */
function my_theme_setup_updater() {
    // 1. Initialize the update checker
    $updateChecker = PucFactory::buildUpdateChecker(
        'https://github.com/your-username/your-private-repo/', // Your repo URL
        __FILE__, // Path to the theme file
        'your-theme-slug' // Theme directory name
    );

    // 2. Authenticate for private repository access
    $token = 'your_github_personal_access_token'; 
    if ($token) {
        $updateChecker->setAuthentication($token);
    }

    // 3. Optional: Specify the branch
    $updateChecker->setBranch('main');
}
add_action('init', 'my_theme_setup_updater');

/**

* Setup automatic updates from a private GitHub repo

function my_theme_setup_updater() {

// 1. Initialize the update checker

$updateChecker = PucFactory::buildUpdateChecker(

'https://github.com/your-username/your-private-repo/', // Your repo URL

__FILE__, // Path to the theme file

'your-theme-slug' // Theme directory name

);

// 2. Authenticate for private repository access

$token = 'your_github_personal_access_token';

if ($token) {

$updateChecker->setAuthentication($token);

}

// 3. Optional: Specify the branch

$updateChecker->setBranch('main');

}

add_action('init', 'my_theme_setup_updater');

How It Works

Update Check: The library periodically checks GitHub for a new release or version change in style.css.
Authentication: Since the repository is private, a GitHub Personal Access Token grants secure access.
Dashboard Notification: When a new version is detected, WordPress displays a “New Version Available” message.
Automatic Installation: Users can update directly from the dashboard.

Pro Tip: Secure Token Management

Instead of hardcoding your GitHub token, use Advanced Custom Fields (ACF) to create an Options Page where you can securely store and update the token without editing code files.

Conclusion

Automating updates for private WordPress themes improves security, scalability, and client experience. It eliminates manual deployment, ensures faster security patches, and gives clients a professional dashboard-level update system.

If you want help implementing secure Git-based deployment workflows or custom WordPress theme development, explore our WordPress development services and let our team streamline your update infrastructure.

Recent help desk articles

Greetings! I'm Aneesh Sreedharan, CEO of 2Hats Logic Solutions. At 2Hats Logic Solutions, we are dedicated to providing technical expertise and resolving your concerns in the world of technology. Our blog page serves as a resource where we share insights and experiences, offering valuable perspectives on your queries.