Storzen Product Tag Assistant
for WooCommerce

What is Storzen Product Tag Assistant?

Storzen Product Tag Assistant adds product tags in WooCommerce automatically. In Rules mode (the default, free, no API key) you define simple rules and the plugin tags products on your own server. In optional AI mode it asks OpenAI, Anthropic (Claude), Google Gemini or DeepSeek for tags, categories and attributes, and lets you review them before anything is saved.

Scripts and styles load only on the product edit screen and on the plugin's own settings tab. Nothing is added to your storefront.

Requirements

Installation

File Structure

Rules Mode

Rules mode is free, needs no API key and sends no data anywhere. Add rules under WooCommerce → Settings → Tag Assistant → Tagging Rules. A product that matches a rule gets that rule's tags.

You can also pick attribute names (for example Material) to turn their values into tags automatically. Rules only add tags; the tags a product already has are kept. Rules are evaluated on your server only when you preview, save a product with auto-tag on, or run a bulk or catalog job.

Product Panel

Every product edit screen has a Tag Assistant panel in the sidebar. Click Get AI Suggestions to get tags, categories and attributes as clickable chips. Selected chips are highlighted; click a chip to deselect it, then click Apply Selected.

What happens when you apply

Bulk Tagging

Select products in Products → All Products, pick a bulk action and click Apply.

A notice reports how many products succeeded and failed. The plugin pauses one second between products to avoid API rate limits, so large batches take longer. Products you are not allowed to edit are skipped and counted as failed.

Catalog Tagging

Tag a whole store without keeping a browser tab open. Go to WooCommerce → Settings → Tag Assistant → Catalog Tagging and choose a job:

The job runs in small batches through Action Scheduler, which is included with WooCommerce, so large catalogs do not hit PHP time limits. A progress bar shows processed of total with tagged and failed counts, and you can Pause, Resume or Cancel at any time.

Built-in safety

• The job stops by itself after 5 failures in a row (for example a wrong key or no API credit). Fix the problem, then click Resume.
• If OpenAI rate-limits a request (HTTP 429), the plugin waits 60 seconds and retries the same product.
• Products the starting user cannot edit are skipped and counted as failed.
• Only one job can run at a time. Deactivating the plugin pauses a running job.

On Products → All Products, the Untagged link above the table lists products that have no tags.

Auto-tag on Save

Turn on Auto-tag on Save to call the AI each time a product is published or updated. It is off by default. If you already clicked Apply Selected in the panel, the next save skips the automatic run so the product is not tagged twice.

AI Providers

Switch to AI mode to use your own account with one provider. Each provider has a fast, low-cost default model and a higher-accuracy model.

Provider model names change over time. Developers can update them without a plugin release through the aptwc_provider_models filter. DeepSeek's privacy policy says data is processed and stored in China, so review it before choosing that provider.

Developers can add more providers with the aptwc_ai_providers filter by implementing Provider_Interface. Applied AI tags replace a product's current tags; categories and attributes are added.

New & Imported Products

Products created outside the product editor never trigger Auto-tag on save. Switch on Tag new products from any source (WooCommerce → Settings → Tag Assistant → Tagging Behaviour) and the plugin tags them for you.

• Covers the WooCommerce CSV importer, the REST API, WP All Import, dropshipping tools and any other plugin that creates products.
• Each new product is queued with Action Scheduler and tagged about 30 seconds later, so the import stays fast and the product's categories and attributes are already saved.
• Works in Rules and AI mode. It is off by default.
• Skip new products that already have tags is on by default, so tags that come with your import file are never replaced.

Safeguards

• If the AI provider rate-limits a request, it is retried up to 5 times with a growing delay.
• After 10 API failures in a row (for example a wrong key or no credit), tagging of new products pauses for 15 minutes instead of retrying thousands of times.
• Products already tagged by the plugin (for example by a catalog job) are skipped.

All Settings

Found under WooCommerce → Settings → Tag Assistant.

REST API

Namespace: /wp-json/storzen-product-tag-assistant-for-woocommerce/v1. Routes need a logged-in user with a valid REST nonce. All use POST except GET /catalog and GET /products/{id}/suggest.

Hooks & Data

Hooks

Stored data

• Post meta: _aptwc_last_tagged, _aptwc_last_tokens
• Options: the settings above plus aptwc_version, aptwc_db_version and aptwc_catalog_job (job state; the API key, custom prompt and job state are not autoloaded)
• Log table {prefix}aptwc_log: product, source, status, applied tags/categories/attributes, tokens used, time
• Uninstalling removes all of the above. Tags and categories already on products are kept.

Privacy & OpenAI

In Rules mode the plugin contacts no external service. In AI mode it sends data only to the one provider you chose (api.openai.com, api.anthropic.com, generativelanguage.googleapis.com or api.deepseek.com), and only when you click Get AI Suggestions or Test API Connection, run a bulk or catalog job, or enable auto-tagging. Nothing is sent on activation.

Data sent: product title, short description, an excerpt of the description, SKU and existing category names. No customer, order or personal data is sent. See the terms and privacy policies of OpenAI, Anthropic and Google and DeepSeek.

Frequently Asked Questions

Changelog