Page cache issue "Uncaught TypeError: element.prop is not a function" with Magento 2.0-2.1.x
Fixing the Page Cache Bug in Magento 2.0–2.1.x When Using Pearl Theme
Starting with Magento 2.2.0, a known page cache bug (GitHub issue #6818) was fixed by the Magento development team.
Since this issue was originally patched in the Pearl Theme, starting with Pearl Theme v1.5.5, the custom theme-level fix was removed in favor of the official Magento fix.
This means:
- If you are using Pearl Theme v1.5.5 or later on Magento 2.2.0 or newer, the issue is already resolved.
- If you are using Pearl Theme v1.5.5 or later on Magento versions earlier than 2.2.0, you will still encounter the page cache bug.
Option 1: Upgrade Magento to 2.2.0 or Higher
The recommended approach is to upgrade your Magento installation to version 2.2.0 or later.
The upgrade automatically resolves the page cache bug without requiring additional patches.
When upgrading Magento, also ensure you are using Pearl Theme v1.5.5 or later, as earlier theme versions still contain the old fix which is no longer needed.
Option 2: Apply a Patch for Magento 2.0–2.1.x
If upgrading Magento is not possible, you can apply a patch provided for Magento versions 2.0–2.1.x.
Steps
- Download the patch file: Page cache 2.0–2.1.x.zip (approx. 5 KB).
Download “Page cache 2.0–2.1.x.zip”
- Extract the archive and copy the included files to your Magento installation, overwriting the existing files.
- From your Magento root directory, run:
- php bin/magento setup:upgrade
- rm -Rf var/cache/ var/generation/ var/page_cache/ var/view_preprocessed/ var/di
These commands update the system and clear cached/generated files to ensure the patch takes effect.
Important Notes
- If you later upgrade your store to Magento 2.2.0 or higher, make sure you are also running Pearl Theme v1.5.5 or higher to avoid conflicts.
- Always back up your site (files and database) before applying patches or upgrades.
By following these steps, you’ll ensure that the page cache bug is resolved whether you’re on Magento 2.0–2.1.x or have the ability to upgrade to Magento 2.2.0+.
Updated on: 16/09/2025
Thank you!