How do I add a favicon to my site?

Easy! Just place a valid favicon.ico in the root directory of your project. And then wait! It can take a while to update.

How do I change the number of posts per page OR the colour of the navigation bar OR the image in the navigation bar OR …?

Beautiful Jekyll is built to be very customizable, and as such, many questions about “how do I change …” can be answered by looking at the _config.yml file and modifying the settings there.

What’s the difference between the config file and the YAML parameters?

Great question! The config file is for site-wide settings, while the YAML parameters are added to each page individually and are applied on a per-page basis.

What if I want to use the same YAML parameter for all pages?

You can set default values for YAML parameters in the config file. Open the _config.yml file, scroll down to the line defaults: and that’s the section you can use. For more information, see the official jekyll documentation about default values.

How can I incorporate new features of Beautiful Jekyll into my old site?

If you installed Beautiful Jekyll using “the easy way” (by forking the GitHub project), then unfortunately there is no easy way to bring all the newest changes into your website. It’s a bit messy, but what most people recommend is to delete your current GitHub project and start fresh: (1) make a copy of any files that you modified/created (generally this means the _config.yml file, all blog posts, and any additional pages you created), (2) delete your project on GitHub, (3) re-fork Beautiful Jekyll, (4) add all the content you previously created. Since this is cumbersome, you might want to try creating your website using “the hard way” this time so that in the future you can update more easily!

If you installed Beautiful Jekyll using “the hard way” (as a ruby gem), then updating to the latest version to get the newest features only requires you to change the version in the config file (for example, change remote_theme: daattali/beautiful-jekyll@4.0.0 to remote_theme: daattali/beautiful-jekyll@5.0.0). You should also look at the updates to see if any Breaking Changes happened.

How do I make small modifications to how my website looks?

If you want to make any visual changes that are not in _config.yml, you’ll need to add your own CSS rules to the file assets/css/custom-styles.css and enable the site-css setting in the config file. This will allow you to overwrite the default Beautiful Jekyll styles. If you don’t know how to use CSS, I highly recommend spending 30 minutes to learn the basics.

How do I use a custom domain for my site?

GitHub lets you have your website for free using their domain. If you want your own domain (such as, it’s easy and will cost about $10-$15 per year. First you need to buy a domain name (I recommend Namecheap) and then follow the instructions GitHub provides.

What if I want a free domain, but not https://<yourusername>

Every GitHub user can have one repository (repository = project) named <yourusername> and the website for that repository will be https://<yourusername>

If you want your project to be named something else, for example MyAwesomeProject, that’s no problem! All you have to do is go to Settings at the top right corner of the page, and rename your repository to MyAwesomeProject (remember to click on the Rename button to confirm!). Then you need to scroll down to the GitHub Pages section and choose “master branch” as the source (not “master branch /docs folder”!).

Now your website will be at https://<yourusername>

How do I move the blog to another page instead of having it on the home page?

The default style of Beautiful Jekyll is to feature the blog feed on the front page. For some sites that’s not the ideal structure, and you may want to have a separate dedicated page for the blog posts. To have the blog hosted on a different URL (for example at <>/blog), copy the index.html file into a folder with the same name as the desired page (for example, to blog/index.html), and in the _config.yml file you need to add a setting paginate_path: "/<page name>/page:num/" (for example paginate_path: "/blog/page:num/").

How do I use math equations in my posts?

MathJax can be easily integrated into your website with a one-line addition. You can see this discussion for more information.

I want to remove the “Powered by …” notice at the bottom

To remove the ad, you need to upgrade your plan.

How do I change the colour scheme to a dark theme?

To unlock this feature, and other features, you need to upgrade your plan.

I really like Beautiful Jekyll, how can I help?

Thank you for asking!

Continuously developing and maintaining this theme is not a simple job, so any level of support would be greatly appreciated!

I have a different question

If you have a question about using Beautiful Jekyll, the best place to start is the official documentation.

To receive support, select one of the different plans Beautiful Jekyll offers. You can also use the Discussions area to try to get help from the community.

Lastly, many questions can be answered by searching Google, the Jekyll documentation, or the Jekyll support forum.