Is there any way to get *useful* failure messages from GitHub Pages?

Most every failure message I’ve ever gotten from GitHub Pages has been useless. Most are just “Page build failed.” I’m now getting failure messages like this:

There was a YAML syntax error on line 3 column 5 in `<unknown>`: `did not find expected key while parsing a block mapping`

Is there any way to get reasonable and useful failure messages?

1 Like

Hi @designedforplaygames, welcome to the GitHub Support Community!

Not directly on GitHub, no. You write in to the support team and ask one of us to look into it for you (if you can share a link to the repository I can do that for you if you like!) and we can often give you a little more information.

The easiest way to do it yourself though would be to build your site locally using Jekyll. If you do that you’ll be able to see the same errors we can see in your terminal. We’ve got some instructions on how to do that here:

https://docs.github.com/en/github/working-with-github-pages/testing-your-github-pages-site-locally-with-jekyll

If you don’t have a Gemfile file in your repository you’ll need to create one in order to build your site with the following content:

source 'https://rubygems.org'
gem 'github-pages', group: :jekyll_plugins

We also have steps for creating a local Jekyll site from scratch that may be useful here:

https://docs.github.com/en/github/working-with-github-pages/creating-a-github-pages-site-with-jekyll#creating-your-site