How to bulk run StoreAgent AI Tasks in WooCommerce

If you’ve got dozens or hundreds of products that need descriptions, summaries, tags, or review overviews, generating them one at a time is painful. StoreAgent’s bulk run lets you select multiple products and run the same AI Task across all of them in one go — directly from the WordPress admin or via WP-CLI for scripted workflows.

This guide covers which AI Tasks support bulk running, how to use the WordPress admin bulk action, how to run the same operation from WP-CLI, and what to watch for as the job processes.

Prerequisites

• StoreAgent installed and connected to a StoreAgent account.
• The AI Task you want to bulk run is enabled in StoreAgent → Settings → AI Content Tools.
• You have permission to manage WooCommerce (your user role can edit products and run bulk actions).
• Sufficient AI Task allowance on your plan to cover the run. Bulk operations show a pre-flight estimate before they start.

AI Tasks that support bulk running

Four AI Tasks support bulk operations today, each with its own input requirement:

• Product Description AI — generates full product descriptions. No special input requirement beyond the product title.
• Product Summaries AI — writes short product summaries from your existing description. Products without a description are skipped.
• Product Tags Generator AI — generates relevant product tags. Products without a description are skipped.
• Review Summaries AI — generates summaries of product reviews. Products without reviews are skipped.

Bulk run AI Tasks from the WordPress admin

The fastest way to bulk run an AI Task is from the WooCommerce Products list.

1. Go to WooCommerce → Products in your WordPress admin.
2. Tick the checkboxes next to the products you want to process. You can select multiple products at once, including across pages.
3. From the Bulk Actions dropdown at the top of the list, choose Run AI Agent.
4. Click Apply.
5. In the Bulk Run AI Agent popup that opens, choose which AI Task to run and confirm.

Heads up: the dropdown still labels the action “Run AI Agent” and the popup says “Bulk Run AI Agent” — those are the literal UI strings today. The label will be renamed to “Run AI Task” in a future update; the behaviour is the same either way.

Monitor progress

After you confirm, an admin notice appears across the top of WP Admin to show the bulk run has started. The job runs in the background — you can keep working in WordPress while it processes.

A log file is created for every bulk run started from the admin UI. Click the link in the admin notice to jump straight to the log, or go to WooCommerce → Status → Logs and find the entry tagged with the StoreAgent source.

How bulk processing works

• Products are processed in chunks of 10 at a time for system stability. You can change the chunk size with the saai_bulk_run_agent_chunk_size filter if you have a tuned hosting environment.
• The AI Task runs against each product in turn. Products that don’t meet the requirements for the chosen AI Task (e.g. no description for Product Summaries AI, no reviews for Review Summaries AI) are skipped automatically and noted in the log.
• Each successful run consumes one AI Task from your plan allowance. Watch the “AI Tasks used” counter in the StoreAgent admin header as the job progresses.
• You can run the same bulk operation again later — already-generated content is overwritten with the new output.

Bulk run AI Tasks via WP-CLI

If you want to script bulk runs, integrate with deployment pipelines, or operate on a fixed list of product IDs, use the WP-CLI command. Bulk run via CLI is available for the same four AI Tasks: Product Description, Product Summaries, Product Tags Generator, and Review Summaries.

Basic usage

wp storeagent <task> <product_ids>

• <task> — the AI Task to run, in kebab-case. Supported values: product-description, product-summaries, product-tags-generator, review-summaries.
• <product_ids> — comma-separated list of WooCommerce product IDs (e.g. 10,20,99,51). No spaces.

Heads up: the CLI command and its --help output still reference “agent” terminology — that matches the internal class naming. The behaviour is the same as “AI Task”.

Example: bulk generate product descriptions for four specific products

wp storeagent product-description 10,20,99,51

The command processes the four products in sequence, prints progress and any errors to the terminal, and writes the generated descriptions back to WooCommerce. No background log file is created for CLI runs — output goes to stdout only.

How CLI bulk runs differ from admin UI bulk runs

• No background queue. CLI runs execute synchronously in the foreground — the whole product list is processed in a single CLI process, not chunked through Action Scheduler. Use it for predictable, scripted runs.
• No log file. Output goes directly to your terminal. Capture it with shell redirection (> output.log) if you need a record.
• You pass the product list. The admin UI works on the products you tick on the Products list; the CLI takes an explicit comma-separated ID list.

Getting CLI help

wp storeagent help

Lists every subcommand the StoreAgent CLI registers — including non-bulk commands like wp storeagent reset-data and wp storeagent upload-data.

Troubleshooting

The “Run AI Agent” option doesn’t appear in the Bulk Actions dropdown

Confirm StoreAgent is installed, activated, and connected to your account at StoreAgent → Settings → Connection. The bulk action is registered by the plugin only when the connection is active. Refresh the Products page after reconnecting.

Some products were skipped during the bulk run

Check the log at WooCommerce → Status → Logs — each skipped product is recorded with the reason. The most common causes are: missing description for Product Summaries / Product Tags Generator AI, no reviews on the product for Review Summaries AI, or the product not being in a published state.

The bulk run started but seems stuck

Bulk runs process in chunks of 10 products via Action Scheduler. Check WooCommerce → Status → Scheduled Actions and search for saai_bulk_run_agent to see queued and processed actions. If a job is stuck in “pending” longer than expected, your site’s cron or Action Scheduler may not be running — see the StoreAgent debug guide for diagnostic steps.

“Insufficient AI Tasks remaining”

Your plan’s AI Task allowance is exhausted. Check the counter in the StoreAgent admin header and upgrade your plan at storeagent.ai/pricing, or wait until your monthly allowance resets if you’re on a paid plan.

Best practices

• Test on a small batch first. Run the bulk operation on 5–10 products before unleashing it on your full catalog. It’s the fastest way to confirm the tone, length, and accuracy of the generated content match your brand.
• Schedule large runs during off-peak hours. Bulk runs are background jobs but still consume server resources. Running 5,000 products against Product Description AI during peak shopping hours is rough on shared hosting.
• Review generated content before relying on it. AI output is a strong first draft — not a final answer. Spot-check a sample after each bulk run, especially the first time you run a new AI Task on your catalog.
• Re-run after content changes. If you update product attributes, categories, or your AI Task’s settings, re-run the bulk operation on affected products to regenerate output with the new inputs.

Need help?

If you have a question or run into any issues, we’re here to help.

• Premium users: Open a support ticket
• Free users: Visit our community forum