Skip to content
woo-product-tag-bulk-update logo

Woo Product Tag Bulk Update

woo-product-tag-bulk-update

Add or remove tags from a filtered set of products (by category, price range, or stock status) with dry-run preview.

SKILL.md

Full skill instructions

woo-product-tag-bulk-update

Purpose

Add or remove one or more tags from a bulk-filtered set of WooCommerce products. Filters include category, price range, stock status, or existing tags. Useful for tagging seasonal collections, sale items, or featured products in bulk. Includes dry-run preview before any products are updated.

Prerequisites

  • WooCommerce store with REST API enabled
  • Consumer Key with Read/​Write scope
  • Minimum WooCommerce version: 3.5.0

Parameters

ParameterTypeRequiredDefaultDescription
store_urlstringyes—Base URL of the WooCommerce store
consumer_keystringyes—WooCommerce REST API consumer key (ck_...)
consumer_secretstringyes—WooCommerce REST API consumer secret (cs_...)
dry_runboolnotruePreview changes without executing
formatstringnohumanOutput format: human or json
actionstringyes—add or remove
tag_idsarrayyes—List of tag IDs to add or remove
filter_category_idintno—Limit to products in this category
filter_tag_idintno—Limit to products with this existing tag
filter_min_pricenumberno—Minimum regular_price
filter_max_pricenumberno—Maximum regular_price
filter_stock_statusstringno—instock, outofstock, or onbackorder

Authentication

WooCommerce uses OAuth 1.0a for HTTP and Basic Auth over HTTPS.

For HTTPS stores (recommended):

Authorization: Basic base64(consumer_key:consumer_secret)

For HTTP stores (development only): Use OAuth 1.0a — include oauth_consumer_key, oauth_nonce, oauth_signature, oauth_signature_method=HMAC-SHA1, oauth_timestamp, oauth_version=1.0

Never log or output consumer_key or consumer_secret values.

See docs/​AUTHENTICATION.md for full setup instructions.

Safety

Step 3 updates product tags on multiple products. Always run with dry_run: true first (the default). Verify the product list in the preview before applying.

Workflow Steps

Step 1 — Resolve tag names

GET /​wp-json/​wc/​v3/​products/​tags?per_page=100&page=1

Build tag ID → name lookup for display in preview.

Step 2 — Fetch filtered products

GET /​wp-json/​wc/​v3/​products
  ?status=publish&per_page=100&page=1
  [&category=<filter_category_id>]
  [&tag=<filter_tag_id>]
  [&stock_status=<filter_stock_status>]

Filter client-side by price range if specified. Extract per product: id, name, sku, tags

Step 3 — Preview or update tags

Compute new tag list:

  • add: merge tag_ids into existing tags (avoid duplicates)
  • remove: subtract tag_ids from existing tags

If dry_run: true: output preview table and stop.

If dry_run: false and confirmed:

PUT /​wp-json/​wc/​v3/​products/​{id}
  Body: { "tags": [{ "id": <tag_id> }, ...] }

API Endpoints Used

GET  /​wp-json/​wc/​v3/​products/​tags    — resolve tag IDs to names
GET  /​wp-json/​wc/​v3/​products         — fetch filtered product set
PUT  /​wp-json/​wc/​v3/​products/​{id}    — update product tags

Pagination Strategy

WooCommerce REST API uses page/​per_page pagination (not cursor-based).

Standard pattern:

page = 1
while True:
  response = GET /​endpoint?per_page=100&page=page
  process(response)
  if len(response) < 100: break
  page += 1

Maximum per_page is 100 for most endpoints. The X-WP-Total and X-WP-TotalPages response headers report totals. Always read X-WP-TotalPages on the first request to estimate job size.

Session Tracking

Claude MUST emit the following output at each stage. This is mandatory.

STARTUP:

╔══════════════════════════════════════════╗
║  SKILL: woo-product-tag-bulk-update      ║
║  STORE: <store_url>                      ║
║  TIME:  <ISO-8601 UTC>                   ║
║  MODE:  <DRY RUN | LIVE>                 ║
╚══════════════════════════════════════════╝

PER-OPERATION (emit after each API call batch):

[N/​TOTAL] <METHOD> <endpoint> → <result_count> records | params: <key>=<val>

COMPLETION (human format):

╔══════════════════════════════════════════╗
║  COMPLETE: woo-product-tag-bulk-update   ║
║  RECORDS PROCESSED: <n>                  ║
║  OUTPUT: stdout                          ║
╚══════════════════════════════════════════╝

COMPLETION (json format):

{
  "skill": "woo-product-tag-bulk-update",
  "store": "<store_url>",
  "completed_at": "<ISO-8601>",
  "records_processed": <n>,
  "output_file": null,
  "dry_run": <bool>
}

Output Format

Human format: a table listing each product, its current tags, and the new tag set.

Error Handling

ErrorCauseResolution
401 UnauthorizedInvalid credentialsVerify consumer_key and consumer_secret
403 ForbiddenKey lacks Read/​Write scopeRegenerate with Read/​Write scope
404 Not FoundTag ID does not existVerify tag IDs via WooCommerce → Products → Tags
429 Too Many RequestsRate limitWait 2 seconds and retry

Best Practices

  • Always run with dry_run: true first (the default). Confirm the product list before applying.
  • Use tag IDs (not names) in tag_ids — fetch them from WooCommerce → Products → Tags.
  • For adding seasonal tags: schedule this skill at the start of the season; use remove at the end.

More skills from navarroido

woo-cancel-and-restock logo
navarroido/Woocommerce-skill

woo-cancel-and-restock

Cancel one or many WooCommerce orders and restore stock quantities for all line items with dry-run preview.

7 0
View
woo-loyalty-segment-export logo
navarroido/Woocommerce-skill

woo-loyalty-segment-export

Read-only: Export customers meeting spend or order-count thresholds for loyalty program enrollment.

7 0
View
woo-order-status-bulk-update logo
navarroido/Woocommerce-skill

woo-order-status-bulk-update

Move a filtered set of orders (by date, current status, or payment method) to a new status with dry-run preview.

7 0
View
woo-variant-attribute-normalizer logo
navarroido/Woocommerce-skill

woo-variant-attribute-normalizer

Read-only: Find product variations where attribute values are inconsistently cased or spelled, and export a normalization report.

7 0
View
woo-low-stock-restock-alert logo
navarroido/Woocommerce-skill

woo-low-stock-restock-alert

Read-only: Query products below a configurable stock threshold and export a prioritized reorder sheet grouped by category.

7 0
View
woo-product-data-completeness-score logo
navarroido/Woocommerce-skill

woo-product-data-completeness-score

Read-only: Score each product against a required fields checklist (images, description, weight, SKU, attributes) and export a completeness gap report.

7 0
View
woo-fulfillment-status-digest logo
navarroido/Woocommerce-skill

woo-fulfillment-status-digest

Read-only: Aggregate order counts by status and flag orders overdue for processing based on a configurable SLA age threshold.

7 0
View
woo-customer-spend-tier-tagger logo
navarroido/Woocommerce-skill

woo-customer-spend-tier-tagger

Segment customers into Bronze, Silver, and Gold tiers based on lifetime total_spent and write the tier as a customer meta field.

7 0
View
woo-bulk-order-notes logo
navarroido/Woocommerce-skill

woo-bulk-order-notes

Append a private or customer-visible note to multiple orders matching a status, date, or payment method filter.

7 0
View
woo-b2b-customer-overview logo
navarroido/Woocommerce-skill

woo-b2b-customer-overview

Read-only: Export customers with a B2B role or meta_data flag including order count, lifetime spend, and last order date.

7 0
View
woo-return-initiation logo
navarroido/Woocommerce-skill

woo-return-initiation

Update order status to returned/refunded and log a timestamped note with return reason.

7 0
View
woo-order-lookup-and-summary logo
navarroido/Woocommerce-skill

woo-order-lookup-and-summary

Read-only: Retrieve a WooCommerce order by ID or customer email and produce a human-readable support summary.

7 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View