GitHub Help

GitHub Pages officially supports the Jekyll plugins found in the GitHub Pages gem. For the exact versions of the Jekyll plugins that GitHub Pages supports, see this list of GitHub Pages dependencies. Other plugins are not supported, so the only way to incorporate them in your site is to generate your site locally and then push your site's static files to your GitHub Pages site.

Jekyll is an active open source project. For information on contributing, see the contributing guidelines.

Configuring Jekyll plugins

You must edit your _config.yml file to add Jekyll plugins to your GitHub Pages site.

Sitemaps for GitHub Pages

GitHub Pages can automatically create sitemaps for your projects.

Repository metadata on GitHub Pages

Common repository information, such as the project name and description, is available to Jekyll sites hosted on GitHub Pages.

Redirects on GitHub Pages

When a Jekyll post or page's title or date changes, existing links to the site may break. For the security of our users, GitHub Pages does not support customer server configuration files such as .htaccess or .conf. However, using the Jekyll Redirect From plugin, you can automatically redirect visitors to the updated URL.

Emoji on GitHub Pages

You can use emoji within any Jekyll page or post, just like you would in a comment or issue within a repository on GitHub Enterprise.

@Mentions on GitHub Pages

You can use @mentions within any Jekyll page or post, just like you would in a comment or issue within a repository.