index.html not working

I have provided an index.html file in my github pages site, however when I try to access it with a root url it throws a 404. When I add /index.html to the end it works perfectly. You can see this happening in the attached image


The repository running the github site is at .


Hmm, I can’t reproduce this - navigating to your website without index.html works fine.  Can you try again now?  And if still doesn’t work, what browser version are you using?


I already restructured the setup of the site, now it is all in the user site instead of project, and I use firefox.


I had this exact error, my index.html was just a plaintext:

hola amigos

Then I changed it to a proper HTML doc:

<!DOCTYPE html>
  <meta charset="UTF-8">
  <title>Página de prueba<title>
  <h1>Hola amiguitos!</h1>
  <footer>gpuma 2017</footer>

 I commited the new changes and it worked fine now.


Hmm, I’m a new developer, but I have the same issue, however, everything mentioned above in terms of <!DOCTYPE html> was already implemented. 

I committed almost 21 hours ago and still nothing. With index.html at the end everything works. I see each product and can click into each product page. 

Without index.html products are missing and only one of the products (The 1st one) redirects to its product page.


Thanks a lot. It’s working as expected after this changes. Thanx.

1 Like

Can you please elaborate the solution as I am facing same problem


I have added front matter part to the and it fixed the problem.

permalink: /index.html

After this it shows index.html. I have found this solution also helps for custom 404 pages.


How can you tell us?

suffering from same problem how do i restructured the setups ?

I have the impression this is a workaround but not a solution. If you access your site via, you want the content of displayed, so people know, what this project is about. If people access your website via, you want the content of index.html displayed. I was under the impression, that the right way to do this, is to exclude from your website by including in your _config.yml:



Now the problems seems to be, that this is not always working as it should.


FWIW, for those (other) newbs out there, I found that if you have an existing repo, what they don’t mention in the GH Pages tutorial, is you just need to to go to settings in the repo, then scroll down to the Github Pages section, and then set the (master) branch (this is disabled by default), and save it.

This should create a page you can then goto in the browser. 

 EDIT: theme is optional - I left it off. 

See photos for visual guide. 


thanks this worked great!

Thanks! This solved my problem! 

Thanks for the tip with the permalink.  It worked right away.

I had the same problem and it was because I had an empty line before<!doctype html> in my index.html


Thanks Louvivien! That was my issue as well–never would have solved it without your tip.

1 Like

I just had this exact same problem, but AFTER it was working

It happened because I had to reset the gh-pages branch. So I

  1. git branch -D gh-pages
  2. git push -d origin gh-pages

Then I had a script create an orphan branch gh-pages, populate it, and push it. Before this, everything worked without /index.html, but after, I had to add /index.html. I must have triggered a bug by accident.

The fix was was go into the settings and change the GitHub Pages Source branch to master, then back to gh-pages. This toggle was able to get around the bugged state I found myself in and everything is good again.

1 Like

Good afternoon! Well managed with HTML-document, please help with the plugin Web craft ic is clearly a problem, when I updated WordPress to 5.3 it became buggy and show on the site abru kadabru had to disable it, can tell me where to register in HTML? Here’s how the site works when the plugin is enabled:

ошибка в плагине.jpg

and so the site works when disabled:

Hope that many isprovlyat in HTML nah so as I only am learning.

This is not related to GitHub pages.

Wordpress is not assosiated with GitHub pages or GitHub in any way, except for being open source.