Back to docs
Troubleshooting

Troubleshooting

The 8 most common "it's not working" questions.

The dashboard shows no data

Almost always one of three things:

  • The Hosted dashboard fields in the WP plugin's Premium page are blank. Paste the API token + dashboard URL.
  • The site has aggressive caching that's serving an old page without the runtime. Purge cache, hit the homepage in an incognito window.
  • The runtime is excluded by your CMP's pre-consent block. Set the data-bots attribute or your bots config to eager so Lighthouse + crawlers see the full tag stack.

PSI before/after shows identical scores

If both runs scored the same and ran within seconds of each other, your edge cache (WP Engine, Cloudflare APO) is normalizing the disable-query param and serving both URLs the same cached HTML. Quickload v0.0.x adds a per-run cache-buster — make sure you're on the latest plugin version, or purge cache and re-run.

Lighthouse scores went down after install

Rare. If it happens, the trigger is likely set to idle or load instead of interaction — both can tank Lighthouse because the audit completes before the trigger fires. Use interaction (the default).

My tags broke

Quickload defers the original <script> tag rather than re-injecting it, so document.currentScript.src, integrity / nonce / async / defer all survive. If a specific tag is broken, set its trigger to eager via the Discovered scripts page — that script fires immediately while everything else stays deferred.

The Lottie animation on my marketing page broke after installing Quickload

Player libraries that DOM-modify before DOMContentLoaded can race the deferred GTM load. Mark the Lottie player's script with data-quickload="eager" or set its trigger to eager in the Discovered Scripts override.

The Critical Tag Wizard fired a vendor twice

The Wizard fires the vendor eagerly; GTM also fires it via the original tag. Pause the matching tag inside GTM after saving the Wizard configuration.

I see "Engine off" in the WP admin

Either the master enable toggle is off, or you're viewing a logged-in admin context where Quickload deliberately disables itself (admins always see the un-deferred state for editing). Log out + visit in incognito to verify.

How do I uninstall?

WP: deactivate + delete the plugin like any other. NPM: remove the init() call. Your CWV beacons stop within minutes; PSI history stays in the dashboard for as long as your account is active.

Still stuck?

Email support@usequickload.com and we'll get you sorted within a business day.