My PR has been approved and merged, but my changes aren't showing up

It usually takes a few minutes for the pages to update.

I've waited more than a few minutes and they still aren't showing up

Very rarely, but on occasion, Github Pages runs into a problem and doesn't upload the changes. You can check this by going to, going to the Settings tab, if you have access, and scrolling down to the Github Pages section to check for an error.

Submitting a new PR will cause it to repair itself. If you want to submit an empty Pull Request (no changes), you can first create an empty commit with the following command:

git commit --allow-empty -m "Trigger GHPages Rebuild"

You can change the message to be whatever is appropriate. After that, submit a new Pull Request.

My changes were merged, but the image is wrong or missing

You will want to check that the image specified in your markdown file matches the image name and does not include a path.

Some of the images are right, but not all of them

First try refreshing the page in case the data is cached in your browser. If that doesn't work, make sure all of the image filenames match.

There are some Unknown boards showing up in addition to the board I added

If the new board you added is showing up and there is also an existing ID for your board, make sure to use that first. To find the ID, Right-click on the Unknown board and choose Inspect. Look for the data-id tag to get the board ID. The correct ID should be the same name as the board's name in CircuitPython. See:

There is an Unknown board and the board I added isn't showing up

Check the formatting of the Markdown file you just added. Extra or too few of spaces can cause it to not be parsed correctly.

This guide was first published on Jul 24, 2019. It was last updated on May 18, 2024.

This page (Troubleshooting) was last updated on Mar 08, 2024.

Text editor powered by tinymce.