Shopware 6.7.11.0+ Compatibility Issues with Node.js 20, 18, and Earlier Versions

While working with Shopware 6.7.11.0 and later, we found that the storefront or administration build may fail with Node.js 18 and earlier versions. Node.js 20 can also cause build issues in some environments. Although Node.js 22 generally works, we recommend using Node.js 24 LTS, as it is actively maintained with full bug and security updates.

Additionally, after switching to Node 24, it is important to clear the npm cache before installing dependencies. Otherwise, npm may continue to use cached packages compiled for the previous Node.js version, causing the build to fail.

Why Does This Happen?

Shopware’s administration and storefront build process rely on modern JavaScript tooling such as:

• npm
• Webpack/Vite
• Babel
• PostCSS
• Various npm dependencies

Many of these dependencies are updated to support newer Node.js versions. Some packages may:

• Require newer Node.js APIs.
• Contain native binaries compiled for a specific Node.js version.
• Have dependency trees that are incompatible with older Node.js releases.

Although Node.js 18 and 20 are LTS releases, some of the latest Shopware frontend dependencies may not work correctly with them.

When switching between Node.js versions, npm can also reuse previously cached packages, resulting in version mismatches or binary incompatibilities.

Recommended Node.js Version

Use Node.js 24

Verify your current version:

Expected output:

Step 1 – Install or Switch to Node.js 24

If using nvm:

Verify:

Step 2 – Clear npm Cache

After switching Node.js versions, clear the npm cache.

This removes cached packages that may have been built for a previous Node.js version.

Step 3 – Build the Storefront

Run the Shopware storefront build.

Example:

or whichever build command is used in your project.

Conclusion

If you’re working with Shopware 6.7.11.0 or later, using Node.js 24 helps avoid storefront build issues that may occur with older Node.js versions. Whenever you switch to a different Node.js version, clear the npm cache before running any build commands or reinstalling dependencies. This ensures packages are rebuilt correctly and helps avoid compatibility issues caused by incompatible cached files.

Following these steps ensures a clean build environment and helps avoid errors related to outdated dependencies or version-specific binaries.