Skip to main content

← All documentation

Troubleshooting

Troubleshooting

Common issues you might hit during install, activation, or daily use β€” with a fix for each. If none of these match what you're seeing, email aoneahsan@gmail.com with the error message and a screenshot.

Install and activation

"Plugin couldn't be activated: PHP version too low"

Empora needs PHP 8.1 or higher. Your host's control panel almost always has a PHP version switcher (cPanel, Hostinger hPanel, Plesk). Switch and try again.

"Plugin couldn't be activated: WooCommerce not installed"

Empora depends on WooCommerce. Install WooCommerce first, then activate Empora.

"Cannot find Empora menu after activation"

The menu sits under WooCommerce β†’ Empora, not at the WordPress root. If you don't see WooCommerce in the admin menu either, the WooCommerce plugin was deactivated.

License activation

"Activation failed: invalid license key"

Re-copy the key from your dashboard. The leading/trailing whitespace from a copy-paste can break the match. The key is a long random string β€” there are no I/l/O/0 lookalike characters in issued keys.

"Activation failed: site already activated"

Each site can hold one active key. If you'd like to swap keys (e.g., from a trial to a paid), deactivate the current key first under WooCommerce β†’ Empora β†’ License.

Premium modules don't appear after activation

Hard-refresh the admin (Ctrl+Shift+R / Cmd+Shift+R) β€” WordPress caches the admin menu. If they still don't appear, deactivate and re-activate the plugin from Plugins.

Module behavior

Email Customizer changes don't show in test emails

WooCommerce caches email previews. Open WooCommerce β†’ Empora β†’ Email Customizer, click Clear preview cache, then Send test.

Reports show "Loading…" forever

A common cause is a cron job that's no longer firing. Visit your site with the query parameter ?disable_cron=true then back β€” this forces a sync. Long-term, install WP Crontrol to inspect the WordPress cron.

Countdown timer keeps resetting to "00:00"

This happens when the server time and the timer end time are in different timezones. Open Settings β†’ General in WordPress and confirm the timezone. Countdown end times should be set in UTC if you set them via REST.

Updates

Update notice appears but the update fails

WordPress writes plugin updates to the filesystem; if your hosting locks the plugin folder, the update fails silently. Two fixes:

  1. SFTP into your site and chmod the /wp-content/plugins/empora-for-woocommerce/ directory to 755. Try the update again.
  2. Manually upload the new zip from your dashboard's Downloads page (the in-plugin updater serves the same file).

"Update available" but my license is expired

Renew your subscription. Without an active license, the premium updater stops serving newer zips. The free build keeps updating from WordPress.org regardless.

Performance

Slow page load after installing many modules

Each module loads only when its admin or storefront feature is used. The slow page load is likely something else (heavy theme, other plugins, low-tier hosting). To confirm: deactivate Empora temporarily; if performance doesn't improve, the issue is elsewhere.

Reports queries cause a slow admin

Reports run on raw WooCommerce queries. For shops with 1M+ orders, our Reports β†’ Settings β†’ Pre-aggregate option computes nightly summaries that load instantly. Premium feature.