Troubleshooting
When the rebuild sulks — checks first, then the usual suspects.
Before you open DevTools, run this list. It catches most “it’s broken” reports, including the ones where it is not.
- Plugin is activated and Enable static generation is on.
- Pretty permalinks are enabled (Settings → Permalinks — not Plain).
- Build Console shows file count and queue status.
- You are testing logged out if skip-logged-in is on.
- A matching file exists under
wp-content/tivlo-static/.
If you skipped step 4, go do step 4. We will wait. We have waited before.
Recovery
When the static layer is in a mood:
Build Console → Clear Static Files (wipes HTML + queue).
Confirm the live site works while logged out (pure WordPress). If that is broken, Tivlo is not the villain.
Full Rebuild, then Process Queue Now until pending is 0.
Re-verify X-Tivlo-Static: hit on key URLs in a private window.
Diagnostics
SELECT id, url, status, attempts, last_error, updated_at
FROM wp_tivlo_ssg_queue
ORDER BY id DESC
LIMIT 50;Use your real table prefix. For local fatals during generation:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );Inspect wp-content/debug.log.
Still stuck?
Gather the exact Recent Failures text, whether the public URL
returns 200 logged-out, whether wp-content/tivlo-static is writable,
WordPress / PHP versions, and whether you tested logged in or out.
That last one is on the quiz.
How is this guide?