---
id: SCR-COM-CAT-011
title: Merchandise item editor
route: >-
  /console/{workspace}/configuration/orders/merchandise/new and
  /console/{workspace}/configuration/orders/merchandise/{id}/edit
surface: console
product_area: commerce
module: catalog
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
purpose: Prepare goods and their storefront presentation through a single editing experience.
supports:
  - JNY-COM-CAT-001
  - CAP-COM-CAT-007
  - CAP-COM-CAT-006
  - CAP-COM-CAT-005
permission: >-
  Listing, Accounting product and merchandise reads; Accounting product create and merchandise create (new),
  or both update grants (edit); listing create or update separately gates storefront fields
entry_from:
  - SCR-COM-CAT-009
  - SCR-COM-CAT-010
exits_to:
  - SCR-COM-CAT-010
displays:
  - field: product fields and standard price
    source: Accounting product
  - field: goods details and variants
    source: 'getMerchandise, listMerchandiseOptionSets'
  - field: 'listing fields, pictures, files and shelves'
    source: 'getProductListing, listProductCategories'
actions:
  - label: Save
    operation_id: createMerchandise
    permission: commerce.merchandise.create and accounting.products.create
    confirm: false
  - label: Save Changes
    operation_id: updateMerchandise
    permission: commerce.merchandise.update and accounting.products.update
    confirm: false
  - label: Save storefront section
    operation_id: updateProductListing
    permission: commerce.product-listings.update
    confirm: false
  - label: Create storefront listing
    operation_id: createProductListing
    permission: commerce.product-listings.create
    confirm: false
states:
  - loading
  - error
validation:
  - BR-CAP-COM-CAT-006-01
  - BR-CAP-COM-CAT-006-04
  - BR-CAP-COM-CAT-006-06
  - BR-CAP-COM-CAT-006-07
  - BR-CAP-COM-CAT-006-10
  - BR-CAP-COM-CAT-006-11
  - BR-CAP-COM-CAT-007-01
  - BR-CAP-COM-CAT-007-06
  - BR-CAP-COM-CAT-007-12
patterns:
  - Standard layout
  - PageHeader
  - SectionPanel
  - EditorActionBar
  - RequireMerchandise
  - EditGate
component: components/commerce/merchandise/merchandise-edit-page.tsx
evidence:
  - >-
    react-console at baf6dae3: components/commerce/merchandise/*.tsx,
    components/commerce/catalog/listing-sections.tsx; lib/commerce/merchandise/live.ts;
    e2e/mock/merchandise.mock.spec.ts.
controls: [TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-CRY-001, TC-LOG-004, TC-PI-001, TC-PI-003]
---

# Merchandise item editor

## What the Screen Is For

Prepare goods and their storefront presentation through a single editing experience.

## What It Shows and Lets People Do

The form combines product fields, delivery and variant details, and listing sections. New goods default to storefront sale, with text derived from the product name. Listing creation and replacement require distinct grants.

## States and Errors

Save performs independent component requests in order and reports incomplete items after a later failure. Slugs, gallery limits, related products and file rules receive local checks. Read and write gates distinguish record facets.

## Patterns It Must Respect

The Standard form uses SectionPanel, EditorActionBar, RequireMerchandise and EditGate. Section-level listing authority is separate from the product and goods write grants.