Use any theme with GitHub Pages

Image of Ben Balter

Just over a year ago Jekyll, the open source project that powers GitHub Pages, introduced shared themes. Since then, you’ve been able to use about a dozen themes to change the look and feel of your GitHub Pages site.

Starting today, you can use any of the hundreds of community-curated themes on GitHub.com. To build your site with any public, GitHub-hosted theme, add the following to your site’s _config.yml file:

remote_theme: owner/name

Replacing owner and name with the repository’s owner and name.

And if you’re interested in making your Jekyll theme available to other users, simply follow the instructions for creating a Gem-based theme, and ensure the repository is public.

For more information, see the Jekyll theme documentation or get in touch.

Catch early bird pricing for GitHub Satellite

Sync up with us and leading developers from around the world in Berlin, May 22-23, and get €100 off regular-priced tickets until April 11.

Get tickets

Join us at Maintainerati

Calling all maintainers: Unite at Maintainerati, a one-day unconference to gather, present, and discuss the day after GitHub Satellite.

RSVP