From bigcommerce-commerce
Manages BigCommerce catalog: products, variants, options, modifiers, categories, brands, metafields, images, bulk operations. For programmatic product data management and integrations.
npx claudepluginhub orcaqubits/agentic-commerce-skills-plugins --plugin bigcommerce-commerceThis skill is limited to using the following tools:
**Fetch live docs**:
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
Fetch live docs:
https://developer.bigcommerce.com/docs/rest-catalog for Catalog API referencesite:developer.bigcommerce.com catalog products variants options for product data modelbigcommerce product options vs modifiers for variant architectureProduct
├── Options (define variant axes — e.g., Color, Size)
│ └── Option Values (Red, Blue, Small, Large)
├── Variants (specific combinations — Red/Small, Blue/Large)
│ ├── SKU, Price, Weight, Image
│ └── Inventory per variant
├── Modifiers (non-variant options — e.g., Engraving Text)
│ └── Modifier Values
├── Images (gallery images)
├── Videos
├── Custom Fields (key-value pairs shown on product page)
├── Metafields (hidden structured data for integrations)
└── Reviews
Core fields:
name, type, sku, descriptionprice, sale_price, retail_price, cost_priceweight, width, height, depthis_visible, availability, conditioncategories — array of category IDsbrand_id — associated brandProduct types: physical, digital
| Feature | Options | Modifiers |
|---|---|---|
| Creates variants | Yes | No |
| Affects SKU | Yes | No |
| Affects inventory | Yes | No |
| Example | Color, Size | Gift wrapping, Engraving text |
| API path | /products/{id}/options | /products/{id}/modifiers |
Each unique combination of option values creates a variant:
sku, price, weight, image_urlinventory_level and inventory_warning_levelid and array of option_valuesCategories are tree-structured:
parent_id — 0 for top-level, otherwise parent category IDsort_order — display orderis_visible — visibility on storefrontProducts belong to one or more categories:
categories array on productSimple flat taxonomy:
name, page_title, meta_keywords, meta_descriptionimage_url — brand logobrand_idKey-value data storage for products, categories, brands, customers, and orders:
app_id + namespace + key = uniqueapp_only, read, write, read_and_sf_accessPOST /v3/catalog/products/{id}/metafieldskey, value, namespace, permission_set, descriptionread_and_sf_access permission to expose in GraphQL Storefront APIPOST /v3/catalog/products/{id}/images — upload or reference by URLimage_url or image_file, is_thumbnail, sort_order, descriptionEach variant can have its own image via image_url field on the variant.
Visible key-value pairs displayed on the product page:
name — field labelvalue — field value/v3/catalog/products/{id}/custom-fieldsPOST /v3/catalog/products
[
{ "name": "Product 1", "type": "physical", "price": 29.99, ... },
{ "name": "Product 2", "type": "physical", "price": 39.99, ... }
]
PUT /v3/catalog/products
[
{ "id": 123, "price": 34.99 },
{ "id": 456, "price": 44.99 }
]
DELETE /v3/catalog/products?id:in=123,456,789
id:in=1,2,3 — by IDsname:like=Widget — name searchsku=ABC-123 — exact SKU matchcategories:in=10,20 — by categorybrand_id=5 — by brandprice:min=10&price:max=100 — price rangeavailability=available — availability filteris_visible=true — visibility filterinclude=images,variants,custom_fields — include sub-resources?page=1&limit=50 — default 50, max 250 per page.
include=images,variants to fetch sub-resources in one requeststore/product/updated, store/product/inventory/updated) for real-time syncpermission_set on metafields based on who needs accessFetch the BigCommerce Catalog API reference for exact endpoint paths, request schemas, and filter options before implementing.