---
id: SCR-COM-CAT-010
title: Merchandise item view
route: '/console/{workspace}/configuration/orders/merchandise/{id}'
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: 'Review one item’s product, goods details, variants and storefront content together.'
supports:
  - JNY-COM-CAT-001
  - CAP-COM-CAT-007
  - CAP-COM-CAT-006
permission: commerce.product-listings.read and accounting.products.read and commerce.merchandise.read
entry_from:
  - SCR-COM-CAT-009
exits_to:
  - SCR-COM-CAT-011
  - SCR-COM-CAT-015
displays:
  - field: 'product: name, code, unit, status, sale window, standard price'
    source: Accounting product read
  - field: 'details: delivery, measures, stock tracking, backorder, variants'
    source: getMerchandise
  - field: 'storefront: state, slug, text, pictures, files, shelves, related items, badges'
    source: getProductListing
actions:
  - label: Edit
    operation_id: updateMerchandise
    permission: commerce.merchandise.update and accounting.products.update
    confirm: false
  - label: Deactivate
    operation_id: updateProduct
    permission: accounting.products.update
    confirm: true
  - label: Publish or Unpublish
    operation_id: updateProductListing
    permission: commerce.product-listings.update
    confirm: true
  - label: Open pricing
    operation_id: getProductPurchasingSettings
    permission: commerce.product-purchasing-settings.read
    confirm: false
states:
  - loading
  - error
  - read-only
  - inactive
validation: []
patterns:
  - PageLayout
  - PageHeader
  - Panel
  - Fact
  - ConfirmDialog
  - RequireMerchandise
component: components/commerce/merchandise/merchandise-view-screen.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 view

## What the Screen Is For

Review one item’s product, goods details, variants and storefront content together.

## What It Shows and Lets People Do

The page groups the three component records. Product and merchandise update authority gates editing; listing authority separately gates storefront changes. Deactivation writes Accounting product status rather than calling retirement.

## States and Errors

Incomplete details remain visible after a partial save. Deactivation and unpublishing ask for confirmation; publication returns the listing to shopper visibility, while unpublishing sets draft.

## Patterns It Must Respect

PageLayout and PageHeader host Panel and Fact sections. ConfirmDialog supports destructive changes, and RequireMerchandise checks all required reads.