# Event: form-error
# DNA-27 / RFC-0027

id: form-error
label: Form Error
description: >
  A form validation error was shown to the visitor. Use errorCode to categorise
  the failure type for funnel drop-off analysis.

category: engagement
autoEmit: false

payload:
  locale:
    type: string
    description: Active locale
    required: true
  formId:
    type: string
    description: Stable machine-readable form identifier
    required: true
  errorCode:
    type: string
    description: >
      Machine-readable error code (e.g. 'required-field-missing', 'invalid-email',
      'network-error'). Must not contain PII.
    required: true