---
title: "EAN for WooCommerce Troubleshooting: Common Errors and Fixes"
description: "Fix greyed-out Pro options, error 500 when EAN tools run on large catalogs, and the Cannot declare class QRcode critical error."
url: "https://wpfactory.com/docs/general-troubleshooting-ean/"
updated: "2026-09-27"
category: Troubleshooting
tags:
  - EAN and Barcodes for WooCommerce
---

# EAN for WooCommerce Troubleshooting: Common Errors and Fixes

To troubleshoot [EAN for WooCommerce](https://wpfactory.com/item/ean-barcodes-woocommerce/), start with the symptom below that matches yours. The three most common are greyed-out Pro options, an error 500 when a tool runs on a large catalog, and a "Cannot declare class QRcode" critical error. Settings are at **WPFactory > EAN** (also reachable at **WooCommerce > Settings > EAN**).

## Pro options are greyed out after you bought Pro

The **Barcodes**, **2D Barcodes**, **Print** and **Extra Fields** sections have an enable box that stays disabled until the Pro plugin is running. Greyed-out boxes mean WordPress is still running the free version.

1. Go to **Plugins** and check that **EAN Barcode Generator for WooCommerce: UPC, ISBN & GTIN Inventory Pro** is installed and active. If not, upload the Pro ZIP from your WPFactory account and activate it.
2. Deactivate the free version. Pro already contains every free feature and uses the same settings, so you only need Pro active.
3. Enter your license key when Pro asks for it, so the plugin can receive automatic updates.
4. Reload **WPFactory > EAN**. The enable boxes should now be clickable.

See [installing the EAN for WooCommerce plugin](https://wpfactory.com/docs/woocommerce-ean-plugin/) for the full steps.

## A tool shows an error 500 on a large catalog

The tools in the **Tools** section (Generate, Copy, Assign, Delete and so on) process every matching product in a single request. On a catalog with tens of thousands of products, that request can run out of PHP memory or time and end in an error 500.

1. Ask your host to raise the PHP memory limit and maximum execution time, then run the tool again.
2. Or work in batches: go to **Products > All Products**, show more products per page with **Screen Options**, select a page of products and choose **Generate EAN** in **Bulk actions**. The bulk action uses the same **Generate** settings and skips products that already have an EAN. Repeat page by page.
3. For new products, set **Tools > Automatic actions > New product** to **Generate**, so each product gets its EAN when it is created and no catalog-wide run is needed later. See [automating EANs with product actions and bulk actions](https://wpfactory.com/docs/ean-product-actions/).

## Critical error: "Cannot declare class QRcode"

EAN for WooCommerce Pro draws QR codes with the QR code class of the TCPDF library it bundles. If another plugin, for example a gift card plugin, has already loaded its own class with the same name, PHP stops with this error the moment a QR code is generated.

1. Until the two plugins are updated to check for each other, go to **WPFactory > EAN > 2D Barcodes** and set **Barcode type** to **Datamatrix (ISO/IEC 16022)** or **PDF417 (ISO/IEC 15438:2006)**. These types do not load the QR code class, so the clash no longer happens.
2. If you need QR codes specifically, send the error log to our support team and to the other plugin's developer.

## General checks

- **Read the error message.** Error messages and the log at **WooCommerce > Status > Logs** often name the file and plugin that caused the problem.
- **Update.** Keep EAN for WooCommerce, WooCommerce and WordPress on their latest versions. Many issues are fixed in updates.
- **Check for conflicts.** Temporarily deactivate other plugins and switch to a default theme. If the problem goes away, reactivate them one by one to find the conflict.
- **Check the guides.** For problems with specific features, see [barcodes missing on printed labels](https://wpfactory.com/docs/ean-barcode-labels-print-problems/), [Google says your generated GTIN is invalid](https://wpfactory.com/docs/ean-gtin-invalid-google-merchant/) and [variations losing or sharing an EAN](https://wpfactory.com/docs/ean-missing-or-duplicated-for-variations/).

## Still stuck?

Need a hand? Our team answers every ticket on the [EAN for WooCommerce support forum](https://wpfactory.com/support/item/ean-barcodes-woocommerce/). Include the exact error message and your plugin version.

Related articles

- [EAN Field Not Visible to Import/Export Tools](https://wpfactory.com/docs/ean-field-not-visible-to-import-export-tools/)
- [Ensure Unique EAN/GTIN Codes: Avoid Duplicates](https://wpfactory.com/docs/unique-ean-gtin-codes/)
- [EAN/GTIN Empty in Feeds After Mapping Custom Attribute](https://wpfactory.com/docs/ean-gtin-empty-in-feeds-after-mapping-custom-attribute/)
- [How to Reset EAN Settings (Section or Whole Plugin)](https://wpfactory.com/docs/reset-ean-settings-section/)
- [Import and Export Product EANs with the WooCommerce CSV Tools](https://wpfactory.com/docs/import-export-product-eans/)

 

[![EAN, UPC, ISBN Generator: Product Barcode Inventory for WooCommerce](https://wpfactory.com/wp-content/uploads/EAN-for-WooCommerce.webp)](https://wpfactory.com/item/ean-barcodes-woocommerce/)
