Use any theme with GitHub Pages

Several years ago, Jekyll, the open source project that powers GitHub Pages, introduced shared themes. Since then, you have been able to use about a dozen themes to change the…

| 1 minutes

Several years ago, Jekyll, the open source project that powers GitHub Pages, introduced shared themes. Since then, you have 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.

Written by

Ben Balter

Ben Balter

@benbalter

Ben Balter is Chief of Staff for Security at GitHub, the world’s largest software development platform. Previously, as a Staff Technical Program manager for Enterprise and Compliance, Ben managed GitHub’s on-premises and SaaS enterprise offerings, and as the Senior Product Manager overseeing the platform’s Trust and Safety efforts, Ben shipped more than 500 features in support of community management, privacy, compliance, content moderation, product security, platform health, and open source workflows to ensure the GitHub community and platform remained safe, secure, and welcoming for all software developers. Before joining GitHub’s Product team, Ben served as GitHub’s Government Evangelist, leading the efforts to encourage more than 2,000 government organizations across 75 countries to adopt open source philosophies for code, data, and policy development.

Related posts