All Collections
Troubleshooting
Features and Optimizations
What to Do if Your Site Appears Broken?
What to Do if Your Site Appears Broken?
Updated over a week ago

In some rare cases, when NitroPack is active, your website may appear with broken or non-responsive sections. This could be related to either NitroPack settings or a conflict with other plugins.

Here are a few steps you can test yourself before reaching out to our Support team for further assistance:


1️⃣ Make sure NitroPack isn't the culprit

You can test the non-optimized version in two ways to make sure we are not causing the issue:

1. Open a new tab and test the problematic URL by adding ?nonitro at the end of it ( ex. https://yourwebsite.com/page/?nonitro )

Adding our ?nonitro parameter to any URL will ensure that the page will show a non-optimized version.

2. Activate Test Mode
You can use Test Mode to test NitroPack in an isolated environment. This way, we would not serve optimizations to live pages.

If the issue persists and you wish to be entirely sure, go to the admin panel of your website and disconnect NitroPack altogether. Then, you can check if the issue persists in an incognito tab.

image1.png

2️⃣ Perform a full cache purge

In rare cases, some of your resources might not be correctly cached. A full purge will delete all cached files, and NitroPack will start optimizing your entire site all over again.

3️⃣ Disable the Remove Unused CSS feature (if applicable)

If you have the Remove Unused CSS feature enabled, try disabling it.

Although it greatly helps with removing unused CSS, it may cause unexpected visual issues on the site, especially on the mobile version.

To run a risk-free test, we recommend trying this on a development copy of the site, if such is available, or enabling Test Mode.

You can enable Test mode through the NitroPack dashboardCache Settings General Test Mode

4️⃣ Switch to a less aggressive optimization mode

The fastest way to check if a setting is causing the issues would be to downgrade to a less aggressive optimization mode.

You can learn more about each optimization mode via the Comparison table.

5️⃣ Switch to Custom Mode

You will automatically be switched to Custom Mode when you start fine-tuning the settings.

Don’t forget to purge your cache and test your website in an incognito tab after applying the abovementioned changes.

In case you have identified the cause for the issue, you can:

  • Disable the feature

  • Tweak its settings (if any)

When making changes to the configuration, we recommend running PSI tests, as the overall performance might be affected.

📌 If you wish to keep the particular feature enabled, or none of the above steps helped, please reach out to our Support team at [email protected] or via this link: https://support.nitropack.io

Did this answer your question?