Skip to content


Subversion checkout URL

You can clone with
Download ZIP
This WP plugin will update GitHub, Bitbucket, and GitLab hosted plugins and themes
PHP JavaScript
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

GitHub Updater

A simple plugin to enable automatic updates to your GitHub hosted WordPress plugins and themes.

This plugin is not allowed in the repo. :frowning:


This plugin was designed to simply update any GitHub hosted WordPress plugin or theme. Your plugin or theme must contain a header in the style.css header or in the plugin's header denoting the location on GitHub. The format is as follows.

GitHub Theme URI: afragen/test-child


GitHub Plugin URI: afragen/github-updater

...where the above URI leads to the owner/repository of your theme or plugin.


  • WordPress 3.4 (tested up to 3.6.1)



  1. Download the latest tagged archive (choose the "zip" option).
  2. Go to the Plugins -> Add New screen and click the Upload tab.
  3. Upload the zipped archive directly.
  4. Go to the Plugins screen and click Activate.


  1. Download the latest tagged archive (choose the "zip" option).
  2. Unzip the archive.
  3. Copy the folder to your /wp-content/plugins/ directory.
  4. Go to the Plugins screen and click Activate.

Check out the Codex for more information about installing plugins manually.


Using git, browse to your /wp-content/plugins/ directory and clone this repository:

git clone

Then go to your Plugins screen and click Activate.



There must be a GitHub Theme URI declaration in the style.css file and you must create a tag in GitHub for each version.

Theme Name: Test
Theme URI:
GitHub Theme URI: afragen/test-child
Version: 0.1.0
Description: Child theme of TwentyTwelve.
Author: Andy Fragen
Template: twentytwelve
Template Version: 1.0.0


In your plugin the following is an example. You do not need to create a tag in GitHub for your plugin version, but if you do create tags, the plugin will use version_compare to determine if your tag is greater than the version in your branch.

Plugin Name:       GitHub Updater
Plugin URI:
GitHub Plugin URI: afragen/github-updater
GitHub Branch:     master
Description: Plugin and Theme Updater classes to pull updates of the GitHub based plugins and themes into wordpress. Theme class based upon <a href="">Whitelabel Framework</a> modifications. Plugin class based upon <a href="">codepress/github-plugin-updater</a>.
Version:           1.0.0
Author:            Andy Fragen
License:           GNU General Public License v2
License URI:
Domain Path:       /languages
Text Domain:       github-updater

Optional plugin headers GitHub Access Token: and GitHub Branch: are available but not required.

The only extra character allowed in a URI is -. Let me know if there is a need for others.


Please log issues on the GitHub at

If you are using a WordPress Multisite installation, theme updating only works when the plugin has been network activated or activated in the main blog (blog_id 1).




This plugin's theme updater class was based upon Whitelabel Framework's updater-plugin.php, which was based upon

The plugin updater class was based upon codepress/github-plugin-updater.

Built by Andy Fragen and contributors

Something went wrong with that request. Please try again.