Configurations

Product and Variant – isActive

The isActive field controls whether a product or variant is considered active in your catalog.
How this status is synchronized between products and their variants depends on a configuration setting:

Setting: Disable sync of isActive status

When Sync Is Disabled (true)

• A product can only be activated if at least one variant is already active.
• If all variants are deactivated, the product is automatically deactivated.
• Activating a variant later does not automatically re-activate the product — you must explicitly activate the product again.
• Deactivating a product does not change variant status.

To activate a product when sync is disabled, you must update the product and at least one variant in the same request.

Example

PATCH /api/Products/{productId}
 
{
  "isActive": true,
  "variants": [
    { "variantId": "{variantId}", "isActive": true }
  ]
}

Result: Product is active because at least one variant is active.

When Sync Is Enabled (false)

• Setting a product to isActive = false will also deactivate all variants.

• Setting a product to isActive = true:

  • If all variants were inactive → they are set to active.
  • If some variants were already active → their states remain unchanged.

• Activating or deactivating individual variants does not affect the product status.

Example

PATCH /api/Products/{productId}
 
{ "isActive": false }

Result: Product and all variants become inactive.

Best Practices

If sync is disabled:

• Always activate at least one variant through the API before activating the product.
• Use product activation only after a variant is active.

If sync is enabled:

• Use product-level activation/deactivation to manage all variants in bulk.

Troubleshooting

• Product won’t stay active → All variants are inactive while sync is disabled. Activate a variant first via the API.
• Product deactivated automatically → All variants were deactivated while sync was disabled.
• Variants didn’t update when product was activated → With sync enabled, variants only update if they were all inactive. Mixed states are preserved.