- How do I add a favicon to my site?
- 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 …?
- What’s the difference between the config file and the YAML parameters?
- What if I want to use the same YAML parameter for all pages?
- How can I incorporate new features of Beautiful Jekyll into my old site?
- How do I make small modifications to how my website looks?
- How do I use a custom domain for my site?
- What if I want a free domain, but not
- How do I move the blog to another page instead of having it on the home page?
- How do I use math equations in my posts?
- I want to remove the “Powered By” notice at the bottom
- How do I change the colour scheme to a dark theme?
- I really like Beautiful Jekyll, how can I help?
- I have a different question
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: firstname.lastname@example.org to
remote_theme: email@example.com). 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
github.io domain. If you want your own domain (such as
https://myname.com), 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
Every GitHub user can have one repository (repository = project) named
<yourusername>.github.io and the website for that repository will be
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
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
<mysite.com>/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
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.