Troubleshooting and FAQ
Still having trouble? Here are a list of common questions and problems people encounter when installing Quartz.
While you’re here, join our Discord :)
My GitHub pages is just showing the README and not Quartz
Make sure you set the source to deploy from
master (and not
/ (root)! See more in the
Some of my pages have ‘January 1, 0001’ as the last modified date
This is a problem caused by
git treating files as case-insensitive by default and some of your posts probably have capitalized file names. You can turn this off in your Quartz by running this command.
Can I publish only a subset of my pages?
Yes! Quartz makes selective publishing really easy. Heres a guide on excluding pages from being published.
Can I host this myself and not on GitHub Pages?
Yes! All built files can be found under
/public in the
master branch. More details under
Do I need a website already?
No! Setting up Quartz means you set up a site too :)
command not found: hugo-obsidian
Make sure you set your
GOPATH correctly! This will allow your terminal to correctly recognize
hugo-obsidian as an executable.
How come my notes aren’t being rendered?
My custom domain isn’t working!
Walk through the steps in the hosting guide again. Make sure you wait 30 min to 1 hour for changes to take effect.
How do I setup Google Analytics?
You can edit it in
config.toml and either use a V3 (UA-) or V4 (G-) tag.
How do I change the content on the home page?
To edit the main home page, open
How do I change the colours?
You can change the theme by editing
assets/custom.scss. More details on customization and themeing can be found in the
How do I add images?
You can put images anywhere in the
/content folder. The only caveat is that you should reference them in your Markdown by prefixing it with a
My Interactive Graph and Backlinks aren’t up to date
By default, the
linkIndex.yaml (which Quartz needs to generate the Interactive Graph and Backlinks) are not regenerated locally. To set that up, see the guide on
Can I use React/Vue/some other framework?
Not out of the box. You could probably make it work by editing
/layouts/_default/single.html but that’s not what Quartz is designed to work with. 99% of things you are trying to do with those frameworks you can accomplish perfectly fine using just vanilla HTML/CSS/JS.
Quartz isn’t perfect! If you’re still having troubles, file an issue in the GitHub repo with as much information as you can reasonably provide. Alternatively, you can message me on Twitter and I’ll try to get back to you as soon as I can.