1) Convert Pages URL → Raw URL
Pages: https://PROJECT.gitlab.io/PATH/file.ext
Raw: https://gitlab.com/GROUP/REPO/-/raw/main/PATH_IN_REPO/PATH/file.ext
Raw is slower to type, but it’s the most reliable when Pages is flapping.
2) Quick checklist
- Try both the directory URL and
/index.html(some caches behave differently). - Prefer GET over HEAD (some edge setups mishandle HEAD).
- If you’re writing verification receipts: log
status,bytes, andsha256(body).
3) Explainer video (3 minutes)
Watch “Receipt Bundles” on YouTube (qq15at0yfYM)
Watch the video
Soft-404 Survival Kit: fix GitLab Pages propagation issues (SHA-256 receipts)