Products Workspace Bulk Edit Workflow

Goal

Use the Products Workspace to generate and write MerchantDrafts content for multiple WooCommerce products in batches.

Important Clarification

This is the MerchantDrafts bulk generation and write-back workflow inside Products Workspace. It is not the generic WooCommerce bulk edit tool for changing arbitrary product fields.

Where To Find It

• Open MerchantDrafts -> Products Workspace.
• Use the Data View and table filters to narrow the product set first.
• Use filters like No tags, No main image, or Not generated when you want a targeted batch.
• If helpful, click Select filtered to turn the current filtered catalogue view into the active queue.
• Select the products you want to process.

Using Data Views to Pre-Scope a Batch

The Data View selector (in the Find row) segments the catalogue before you apply any other filters:

• Top 20 by Value — focus bulk generation on the most financially important products first
• Rest of Stock — work through the remainder of in-stock products after the top tier is done
• Backorderable — generate content for out-of-stock products that can still be sold via backorder

Data Views and content filters stack — for example, combine "Top 20 by Value" with "Not generated" to find your highest-value products that still need content.

Safe Workflow

1. Start with a small batch so you can confirm the flow.
2. Click Generate content.
3. MerchantDrafts processes the selected products one by one and prepares generated content, image fields, and WooCommerce tags.
4. Open the Generated Content review drawer to inspect the generated package before applying it.
5. Use the review tabs:

• Ready to write = generated draft is newer than the live product fields
• Written = latest generated draft has already been applied to the product

1. Review the table row state and generated status.
2. When the selected products show newer generated content waiting to be applied, click Write generated content.
3. Confirm the row status and applied timestamp after the write step completes.

Row-Level Shortcuts

You can also work directly from the catalogue row:

• Generate starts generation for a single product
• Write appears only when that row has newer generated content waiting
• the product title opens the normal product edit screen
• the external-link icon opens the live product page

What Step 2 Does

Generate content in Products Workspace runs the same generation action used in the product row flow, but in batch form for the selected products.

It prepares:

• generated product copy
• image-field values when enabled
• WooCommerce tags produced by the generation package

What Step 3 Does

Write generated content writes the selected generated values into the live WooCommerce product fields for the selected rows.

Use it only after Step 2 has prepared newer generated content for those products.

Writeback Meanings

• Generated means a draft exists for the product.
• Ready to write means a draft exists and is newer than what is currently applied to the live WooCommerce product fields.
• Written means the latest generated draft has already been applied to the product.

This means a product can be generated and later become Ready to write again if you regenerate newer content.

Review Drawer

The review step now uses a wide right-side drawer rather than a separate full page.

It includes:

• Full view for reading the generated content package in detail
• Compact view for scanning many generated products quickly
• writeback grouping tabs: Ready to write, Written, Show all
• a sticky action bar that shows how many products are ready and lets you trigger Step 3 write-back directly from the drawer

Use the drawer to confirm what should be written back before running Step 3.

From the review cards themselves, operators can now:

• select or deselect a product without returning to the table first
• jump directly back to the matching catalogue row

Recommended Operator Pattern

• Filter the catalogue first.
• Select a focused batch.
• Watch the workspace scope counters so you can distinguish filtered rows from the selected queue before running Step 2 or Step 3.
• Run Generate content.
• Review the generated state before writing.
• Run Write generated content only for rows you want to apply.
• Use larger batches only after you are comfortable with the timing and output quality.

Practical Notes

• One product can take multiple seconds to process, so bulk runs are sequential rather than instant.
• Start with a few products first if you are testing a new prompt stack or brand configuration.
• If the current selection is already generated, you may not need Step 2 again unless you want to regenerate.
• Step 3 is only relevant for selected products that have newer generated content waiting to be written.
• If rows are already Generated and already Written, the bulk write button stays inactive on purpose.
• Catalogue now includes a Content state selector so you can isolate Generated, Not generated, Ready to write, or Written products before selection.
• The workspace can also show a Tags column so you can visually confirm which products have No tags.
• Bulk generation safeguards now warn operators at 20+ and 50+ selected products, and require an explicit confirmation at 100+.

Validation

• The selected rows show generation progress during Step 2.
• The selected rows show applied/write status after Step 3.
• The product fields are updated only for the rows you selected for the write-back action.