---
id: SCR-PFM-MTD-005
title: Contact console forms
route: /console/{tenantId}/configuration/{module}/forms/console/contacts
surface: console
product_area: platform
module: metadata
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
purpose: Administrators manage the named contact forms used by staff. This screen opens existing designs and starts
  new ones.
supports:
- CAP-PFM-MTD-008
permission: crm.contact-layouts.read to view; crm.contact-layouts.create and .delete to change (evaluated by Platform
  behind platform.layouts.*)
entry_from:
- SCR-PFM-MTD-004
exits_to:
- SCR-PFM-MTD-006
displays:
- field: Saved contact console forms by name, with description
  source: listConsoleForms (purpose contacts)
actions:
- label: New form (from the default, blank, or a copy)
  operation_id: 'none: opens the designer with ?from='
  permission: crm.contact-layouts.create
  confirm: false
- label: Open
  operation_id: 'none: opens the designer'
  permission: crm.contact-layouts.read
  confirm: false
- label: Delete
  operation_id: deleteConsoleForm
  permission: crm.contact-layouts.delete
  confirm: true
states:
- loading
- error
- empty
- read-only
validation:
- BR-CAP-PFM-MTD-008-01
- BR-CAP-PFM-MTD-008-04
- BR-CAP-PFM-MTD-008-08
- BR-CAP-PFM-MTD-008-11
patterns:
- PageLayout (standard width)
- PageHeader
- ConfigBreadcrumb
- EmptyState
- LoadingIndicatorPanel
- create form dialog
- confirmation dialog for delete
component: components/forms/management/contact-forms-list.tsx
evidence:
- 'react-console at baf6dae3: app/(console)/console/[tenantId]/configuration/[module]/forms/console/contacts/page.tsx;
  components/forms/management/contact-forms-list.tsx, create-form-dialog.tsx; lib/forms/storage/console-forms.ts'
controls: [TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-CRY-001, TC-CRY-002, TC-CRY-003, TC-CRY-004, TC-DAT-001, TC-DAT-003, TC-DAT-004, TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-003, TC-PI-005, TC-PRV-001, TC-PRV-002, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-TEN-004, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---

# Contact console forms

## What the Screen Is For

Administrators manage the named contact forms used by staff. This screen opens existing designs and starts new ones.

## What It Shows and Lets People Do

The list shows saved names. New designs can begin from default content, a blank document or a copy, and persistence occurs on save. Deletion is blocked while an assignment still uses the form.

## States and Errors

Failed reads and deletion refusals remain visible. The deletion response identifies referring records; callers with only read access receive no mutation controls.

## Patterns It Must Respect

The built configuration list uses creation choices and a confirmation dialog for removal.