=== CategoriX: AI Product Categorization for WooCommerce === Contributors: categorix Tags: woocommerce, categorization, ai, product categories, catalog Requires at least: 5.8 Tested up to: 6.9 Stable tag: 1.1.1 WC requires at least: 5.0 WC tested up to: 10.5 Requires PHP: 7.4 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Automatically categorise your WooCommerce products in minutes — using your store's own categories. == Description == CategoriX analyses your product titles and descriptions and assigns the best-fit category in your WooCommerce category tree — without fragile keyword rules or hours of manual sorting. It's designed for stores with messy or fast-growing catalogues: dropshipping, multi-supplier imports, agencies, and anyone tired of "Uncategorized". [Get started with CategoriX](https://categorix.ai/woocommerce) = How It Works = 1. **Connect** — Paste your API key from [CategoriX](https://categorix.ai/woocommerce). Your WooCommerce categories sync automatically. 2. **Bulk categorise** — Start a bulk categorisation run from the dashboard. Products are processed in the background using WooCommerce's Action Scheduler, so your site stays responsive. 3. **Review** — High-confidence matches can be applied automatically. Anything uncertain goes into the Review Queue for your approval. 4. **Keep it tidy** — Optionally auto-categorise new products as they're created, so your catalogue stays organised over time. CategoriX is powered by the same core engine built for ~99% accuracy, while confidence scoring ensures you stay in control when matches are uncertain. = Key Features = * **AI categorisation (to your WooCommerce categories)** — Uses product title and description to pick the best category in your store. * **Confidence scoring** — Every suggestion gets a 0–100 confidence score, with thresholds you control. * **Background bulk processing** — Categorise large catalogues safely in the background (no timeouts, no "freeze the admin" moments). * **Review Queue** — Clear current vs suggested category comparison. Approve, reject, or revert with one click. * **Safety Lock** — Skips products that have been manually categorised by a human (and by default focuses on "Uncategorized"). * **Category tree sync** — Your WooCommerce categories are synced so products map to your real store structure. * **Revert anytime** — Undo individual changes or roll back a whole batch. * **Auto-categorise new products** — Optionally categorise new products as they're added. = Requirements = * WooCommerce 5.0 or later * PHP 7.4 or later * A CategoriX account and API key — [Get started](https://categorix.ai/woocommerce) = Pricing = CategoriX offers simple monthly plans for WooCommerce stores of all sizes. Every plan includes bulk categorisation, automatic category sync, and confidence scoring. [View current plans and pricing](https://categorix.ai/woocommerce) == Installation == 1. Download CategoriX from WordPress.org or search for "CategoriX" under **Plugins > Add New** in your WordPress admin. 2. Activate the plugin. 3. [Create a CategoriX account](https://categorix.ai/woocommerce) if you don't have one already. 4. Go to **CategoriX > Settings** and paste your API key. 5. Click **Save & Connect** — your categories will sync automatically. 6. Head to **CategoriX > Dashboard** and start categorising. == Frequently Asked Questions == = Do I need a CategoriX account? = Yes. The AI categorisation is powered by the CategoriX cloud service. [Create a free account](https://categorix.ai/woocommerce) to get your API key and start categorising. = Will it overwrite my existing categories? = No. By default, CategoriX only processes products sitting in "Uncategorized". The Safety Lock feature protects anything you've manually categorised. You can also choose to re-categorise all products if needed. = How accurate is the AI? = CategoriX is built for ~99% accuracy. The AI understands product context — not just keywords — by analysing titles, descriptions, brands, and attributes. Any result that isn't high-confidence is sent to the Review Queue for your approval, so you always have the final say. = Does it work with large catalogues? = Absolutely. CategoriX processes up to 500 products per minute in the background using WooCommerce's Action Scheduler. Your site stays fully responsive, and it can comfortably handle catalogues with millions of products. = Can I undo the changes? = Yes. Every change is tracked. You can revert individual products or roll back an entire batch from the Review Queue. = What data is sent to the API? = Product name, description, brand (if available), current category, and product attributes are sent to the CategoriX API for classification. No customer data, order data, or payment information is ever transmitted. == Screenshots == 1. Dashboard with catalogue health overview and bulk categorisation wizard 2. Bulk categorisation with live progress tracking 3. Review Queue — approve, reject, or revert AI suggestions 4. Settings page with one-click API connection == Changelog == = 1.1.1 = * Improved compatibility with WordPress.org plugin guidelines * Security and output escaping improvements = 1.1.0 = * One-click setup — paste your API key and go * Automatic category tree sync for better accuracy * Account usage and credits display * Catalogue health progress bar * Refreshed UI * Improved Safety Lock behaviour * Bug fixes and stability improvements = 1.0.0 = * Initial release == Upgrade Notice == = 1.1.1 = Compatibility and security improvements. = 1.1.0 = Setup is now easier — just paste your API key and click Save & Connect. Categories sync automatically.