Fix the Zen Cart Blank White Page (WSOD)

The blank white page — also called the White Screen of Death (WSOD) — is the most common Zen Cart error. The page loads but shows absolutely nothing: no header, no error message, no content. This happens because PHP is throwing a fatal error but your server is configured to suppress it rather than display it.

The good news: once you can see the actual error message, the fix is usually straightforward. Here's how to get there.

Step 1 — Enable error reporting

Before you can fix anything, you need to see what PHP is actually complaining about. Zen Cart has a built-in way to enable visible error reporting.

// Add this temporarily to see PHP errors
define('STRICT_ERROR_REPORTING', true);
error_reporting(E_ALL);
ini_set('display_errors', 1);

Reload the blank page. You should now see an actual PHP error message. Note the file name and line number — this tells you exactly where the problem is.

Step 2 — Check PHP version compatibility

The most common cause of a sudden WSOD after a hosting change or server update is a PHP version mismatch. Here's what's compatible:

• Zen Cart 1.5.8: PHP 7.4 – 8.1 (PHP 8.2+ will break things)
• Zen Cart 2.0.x / 2.2.2: PHP 7.4 – 8.3
• Zen Cart 1.5.7 and earlier: PHP 5.6 – 7.4 (very old — upgrade is strongly recommended)
• Zen Cart 1.3.9 and older: Requires PHP 5.x — almost impossible to run on modern hosting

To check your current PHP version, create a file called phpinfo.php in your webroot with this content, then visit it in your browser:

<?php phpinfo(); ?>

If your PHP version is incompatible, contact your host to downgrade PHP (a temporary fix) or contact us to upgrade your Zen Cart version to one that supports modern PHP.

Step 3 — Isolate a broken plugin or module

If you recently installed or updated a plugin and the WSOD appeared immediately after, the plugin is almost certainly the cause.

Step 4 — Check file permissions

Incorrect file permissions can cause blank pages, especially after FTP uploads or server migrations. Zen Cart files and folders need specific permissions to work correctly.

• Folders: should be set to 755
• Files: should be set to 644
• configure.php files: should be 444 (read-only) on a live store

You can check and fix permissions via your hosting control panel's file manager, or via SSH:

# Set all folders to 755
find /path/to/zencart -type d -exec chmod 755 {} \;

# Set all files to 644
find /path/to/zencart -type f -exec chmod 644 {} \;

# Lock configure.php
chmod 444 includes/configure.php
chmod 444 admin/includes/configure.php

Step 5 — Increase PHP memory limit

Large Zen Cart stores with many products, complex templates, or several active modules can run out of PHP memory, causing a silent fatal error (and therefore a blank page).

Add this to your .htaccess file in the Zen Cart root:

php_value memory_limit 256M

If that doesn't work (some hosts don't allow .htaccess overrides), you can try adding this to the top of index.php:

<?php
ini_set('memory_limit', '256M');

Step 6 — Check the Zen Cart error log

Zen Cart writes its own error log separate from your server's Apache/PHP error log. Check this file for detailed error traces:

/logs/myDEBUG-xxxxxxx.log

If there are multiple log files, sort by date modified and open the most recent one. Look for lines marked PHP Fatal error or PHP Parse error — these will point directly to the broken file.

When to call a professional

Consider getting professional help if:

• The error message mentions a core Zen Cart file (not a plugin) — this may indicate file corruption or a hacking attempt
• You've followed all the steps above and still see a blank page
• Your store went blank after a hosting migration or server PHP upgrade
• The WSOD only affects certain pages (admin, checkout, a specific category) — this usually requires detailed diagnosis
• You're running Zen Cart 1.3.x or early 1.5.x on PHP 8 — this requires a proper upgrade, not a quick fix