Troubleshooting

import { Aside } from ‘@astrojs/starlight/components’;

Troubleshooting

This page covers the most common issues users encounter with Colvor plugins.

License Issues

“License key invalid or not found”

Cause: The key may have extra whitespace, or was entered incorrectly.

Fix:

1. Open your Lemon Squeezy purchase email.
2. Copy the key using Ctrl+A to select all text in the key field.
3. Paste it fresh into the Colvor license field and click Activate.

“This domain is already activated”

Cause: The license is already linked to another domain (or a previous version of this domain).

Fix: Log in to your Colvor account, find the license, and click Deactivate next to the old domain. Then re-activate on your current domain.

License validates successfully but plugin shows “inactive”

Cause: Cached validation result is stale.

Fix:

1. Go to WooCommerce → Status → Tools.
2. Click Clear transients.
3. Reload the Colvor settings page.

---

Plugin Conflicts

White screen of death (WSOD) after activation

**Do not panic.** This is almost always caused by a PHP version mismatch or plugin conflict — not data loss.

Fix:

1. Deactivate all other plugins via FTP (rename the /wp-content/plugins/ folder temporarily).
2. Re-activate Colvor alone to confirm it works.
3. Re-activate other plugins one-by-one to identify the conflict.

WooCommerce hooks not firing

Cause: A theme or another plugin is calling remove_all_actions() or remove_all_filters() on WooCommerce hooks.

Fix: Enable Debug Mode in Colvor Settings to get detailed logs, then check WooCommerce → Status → Logs for hook-related warnings.

---

Performance Issues

High CPU on license validation

Colvor caches all license validations locally using WordPress transients. By default, re-validation only happens every hour. If you’re seeing repeated validation calls, your transient cache may be getting cleared too aggressively by a caching plugin.

Fix: Exclude Colvor transients (prefixed colvor_) from your object cache flush rules.

---

Still Stuck?

If none of the above solutions work, please open an issue on GitHub with:

1. Your WordPress and WooCommerce version
2. Your PHP version
3. A copy of the WooCommerce status log (WooCommerce → Status → Logs)