Troubleshooting & FAQ
Build errors, browser quirks, search issues, and the questions people ask most.
Common issues and fixes
A running list of the problems that come up most often and the diagnostic steps that resolve them. Check here before opening a bug report.
Build errors
A field guide to the most common Eleventy build failures and how to diagnose them. Covers front-matter syntax, template errors, data-file bugs, and missing dependencies.
Search issues
What to check when Pagefind search returns no results, shows stale content, or fails to load entirely. Covers index generation, deployment, and browser-side issues.
Deploy failures
How to diagnose and fix the most common reasons a Cloudflare Pages or Netlify build fails, including Node version mismatches, missing environment variables, and Pagefind errors.
Translation issues
How to diagnose and fix the most common problems with the GTranslate.io language picker, including issues with the language staying stuck, the dropdown not opening, and translated text not resetting.
CSS and images not updating
Why CSS changes and new images sometimes don't appear after a deploy, and how to force browsers and CDNs to serve the latest version.
Undo and rollback
How to unpublish an article, revert a mistake, restore a deleted file, and re-deploy after a problem.
Cloudflare cache issues
Why your changes aren't showing up after a deploy, and how to clear Cloudflare's cache to force fresh content.
If this category should cover a topic that isn't here yet, send us feedback.