Once Jekyll is running, you can start with basic configuration by adding various entries to _config.yml. Besides the documentation here, the file is also extensively documented. If you’re using the gem-based theme, the _config.yml in the root directory is provided by Jekyll and does not contain any documentation. However, you can get the example config file here.

NOTE: When making changes to _config.yml, it is necessary to restart the Jekyll process for the changes to take effect.

Table of Contents

Setting url and baseurl

The first order of business should be to set the correct url and baseurl values in _config.yml.

The url is the domain of your site, including the protocol (http or https). For this site, it is


If your entire Jekyll blog is hosted in a subdirectory of your page, provide the path in baseurl with a leading /, but no trailing /, e.g.

baseurl: /hydejack

Otherwise, provide the empty string ''

GitHub Pages

When hosting on GitHub Pages (unless you are using a custom domain), the url is

url: https://<username>

The baseurl depends on the kind of page you are hosting.

  • When hosting a user or organization page, use the empty string.
  • When hosting project page, use /<reponame>.

For for information on the types of pages you can host on GitHub, see the GitHub Help article.