Live Editing Products

You can make immediate edits to products that are live on your storefront even if your product publishing setting is set to staged and you currently have pending draft changes for that product using the live editing feature of the Kibo Composable Commerce Platform.

For example, you have a product live on your storefront, your product publishing setting is set to staged and you have a pending draft change for the same product. However, you notice that the price is incorrect for the product and needs to be updated immediately without going to a pending draft. You can use the live editing feature to edit the product price on your live storefront without affecting your pending draft change.

You can currently only use the live editing feature with the API. However, you must first enable it within Admin.

Live edits made to a product don't automatically apply to the pending drafts of a product. If you make a live edit to a product, you'll need to make the same edit to the pending draft of the product. Otherwise, if you make a live edit to a product without making the same edit to the pending draft, when you publish the pending draft your previous live edit gets overwritten.

Enable Live Editing

To enable the live editing feature:

  1. In Admin go to System > Settings > Publishing.
  2. Ensure your product publishing setting is set to Staged.
  3. Check the Live Edit checkbox to enable live editing.

Callout of the Live Edit toggle for a master catalog

Make Live Edits

The data view mode header, x-vol-dataview-mode, controls whether your edits are made to the product's live version or the pending draft version. The data view mode header can have a value of either pending or live.

When the data view mode header is set to Live and you've enabled live editing, your edits are made to the product's live version. When the data view mode header is set to Pending, your edits are made to the product's pending draft version.

To make a live edit to a product once you've enabled live editing:

  1. Set the data view mode header to Live.
  2. Make a Product Put request, such as UpdateProduct or UpdateProductInCatalog.

PublishState Field

The PublishingInfo.PublishState field in the product response body indicates whether a pending draft version of the product exists. Refer to the following table for more information about possible PublishState values:

ValueDescription
NewIndicates that the product has not yet been published and no live version exists.
DraftIndicates that both a draft version and a live version of the product exist.
LiveIndicates that only a live version of the product exists.

Supported Product Properties

You can make live edits to the following product properties:

  • productInCatalogInfo.isActive
  • productInCatalogInfo.productLocalizedContent.productName
  • productInCatalogInfo.productLocalizedContent.productShortDescription
  • productInCatalogInfo.productLocalizedContent.productFullDescription
  • productInCatalogInfo.productLocalizedContent.productImages
  • price.price
  • price.salePrice
  • price.msrp
  • supplierInfo.cost
  • isTaxable
  • price.map
  • price.mapStartDate
  • price.mapEndDate
  • pricingBehavior.discountsRestricted
  • pricingBehavior.discountsRestrictedStartDate
  • pricingBehavior.discountsRestrictedEndDate
  • inventoryInfo.manageStock
  • inventoryInfo.outOfStockBehavior
  • supplierInfo.mfgPartNumber
  • supplierInfo.distPartNumber
  • upc
  • productInCatalogs.dateFirstAvailableInCatalog
  • properties
  • extras
  • options
  • fulfillmentTypesSupported
  • isPackagedStandAlone
  • standAlonePackageType
  • packageHeight
  • packageWidth
  • packageLength
  • packageWeight
  • productInCatalogs.catalogId
  • seoContent

Editing a product's code always affects the live version of the product, regardless of the product publishing setting.