---
id: ADR-COM-CAT-001
title: Custom Fields Remain Opt-In and Undeclared
product_area: commerce
module: catalog
revision: 1
status: proposed
design_intent: confirmed
source_sha:
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
decision: Commerce records use standard fields and purpose-built editing without a custom-field capability.
constrains:
  - DOM-COM-CAT-001
  - DOM-COM-CAT-002
  - DOM-COM-CAT-003
  - DOM-COM-CAT-004
  - DOM-COM-CAT-005
  - DOM-COM-CAT-006
  - SVC-COM-CAT-configuration
  - SVC-COM-CAT-catalog
  - SVC-COM-CAT-merchandise
  - SVC-COM-CAT-pricing
  - SVC-COM-CAT-promotions
  - SVC-COM-CAT-recommendations
origin: 'R2-ARCH-001 (Andrew, 2026-10-19), copied into COMM-M1 plan section 7a'
alternatives:
  - option: Enable customer extensions on selected campaigns or listings
    why_not: This requires a new product declaration; the current Commerce register does not permit it.
  - option: Retain the earlier campaign extension-value storage
    why_not: The capability repair removed that mechanism.
consequences:
  - Additional customer attributes require an approved declared capability.
  - Existing editing uses record-specific design-system components.
  - The promotion registration has no capability block enabling custom fields.
supersedes: []
evidence:
  - >-
    services-commerce at c8b66a98: AGENTS.md (Custom Fields Are Opt-In Per Entity);
    docs/milestones/plans/COMM-M1-plan.md (7a. Entity capabilities);
    modules/promotions/metadata/promotions.object.ts; modules/merchandise/aws/api/merchandise.schemas.ts.
---

# Custom Fields Remain Opt-In and Undeclared

## Context

Product controls which record types can be extended with custom fields. The approved Commerce capability register declares none for this scope.

## Decision

Commerce records use standard fields and purpose-built editing without a custom-field capability.

## Alternatives Considered

Enable customer extensions on selected campaigns or listings. This requires a new product declaration; the current Commerce register does not permit it.

Retain the earlier campaign extension-value storage. The capability repair removed that mechanism.

## Consequences

Additional customer attributes require an approved declared capability. Existing editing uses record-specific design-system components. The promotion registration has no capability block enabling custom fields.