Validation rules for brand display names including locale, name content, primary flags, and uniqueness constraints

Display Names

DisplayNamesMustBePresent

Definition	Severity	API	Sample	Mode
Validate that displayNames are present			Link

Example Validation Report

{
  "code": "VALIDATION__DisplayNamesMustBePresent",
  "severity": "VIOLATION",
  "message": "Field '{{field}}' must be present",
  "context": {
    "field": "displayNames"
  }
}

Locale

DisplayNamesLocaleMustBePresent

Definition	Severity	API	Sample	Mode
Validate that locale is present			Link

Example Validation Report

{
  "code": "VALIDATION__DisplayNamesLocaleMustBePresent",
  "severity": "VIOLATION",
  "message": "Field '{{field}}' must be present",
  "context": {
    "field": "locale"
  },
  "details": {
    "createdDate": "2026-02-10T11:36:02.00Z",
    "submitted": [
      {
        "field": "$.brandDetails.displayNames[0]"
      }
    ],
    "compared": [],
    "expected": []
  }
}

DisplayNamesLocaleMustBeValid

Definition	Severity	API	Sample	Mode
Validate that locale is valid			Link

DisplayNamesLocaleMustNotBeEmpty

Definition	Severity	API	Sample	Mode
Validate that locale is not an empty string

Example Validation Report

{
  "code": "VALIDATION__DisplayNamesLocaleMustNotBeEmpty",
  "severity": "VIOLATION",
  "message": "'locale' must not be empty string"
}

Name

DisplayNamesNameMustBePresent

Definition	Severity	API	Sample	Mode
Validate that name is present			Link

Example Validation Report

{
  "code": "VALIDATION__DisplayNamesNameMustBePresent",
  "severity": "VIOLATION",
  "message": "Field '{{field}}' must be present",
  "context": {
    "field": "name"
  },
  "details": {
    "createdDate": "2026-02-10T11:36:02.00Z",
    "submitted": [
      {
        "field": "$.brandDetails.displayNames[0]"
      }
    ],
    "compared": [],
    "expected": []
  }
}

DisplayNamesNameMustNotBeDummyCharacters

Definition	Severity	API	Sample	Mode
Validate that name is not dummy characters			Link

Example Validation Report

{
  "code": "VALIDATION__DisplayNamesNameMustNotBeDummyCharacters",
  "severity": "VIOLATION",
  "message": "'{{value}}' in '{{field}}' is dummy characters",
  "context": {
    "field": "name",
    "value": "No value"
  },
  "details": {
    "createdDate": "2026-02-10T11:36:02.00Z",
    "submitted": [
      {
        "field": "$.brandDetails.displayNames[0].name",
        "value": "No value"
      }
    ],
    "compared": [],
    "expected": []
  }
}

DisplayNamesNameMustNotBeEmpty

Definition	Severity	API	Sample	Mode
Validate that name is not an empty string			Link

Example Validation Report

{
  "code": "VALIDATION__DisplayNamesNameMustNotBeEmpty",
  "severity": "VIOLATION",
  "message": "'name' must not be empty"
}

DisplayNamesNameHasUnsupportedCharacter

Definition	Severity	API	Sample	Mode
Validate that name does not include an unsupported character			Link

Example Validation Report

{
  "code": "VALIDATION__DisplayNamesNameHasUnsupportedCharacter",
  "severity": "VIOLATION",
  "message": "'{{field}}' has unsupported character",
  "context": {
    "field": "name"
  },
  "details": {
    "createdDate": "2026-02-10T11:36:02.00Z",
    "submitted": [
      {
        "field": "$.brandDetails.displayNames[0].name",
        "value": "Bob's Burgers\n"
      }
    ],
    "compared": [],
    "expected": []
  }
}

DisplayNamesNameMustNotIncludeURL

Definition	Severity	API	Sample	Mode
Validate that name does not include a URL			Link

Example Validation Report

{
  "code": "VALIDATION__DisplayNamesNameMustNotIncludeURL",
  "severity": "VIOLATION",
  "message": "'{{field}}' is '{{value}}' and includes URL",
  "context": {
    "field": "name",
    "value": "Walmart (https://www.walmart.com)"
  },
  "details": {
    "createdDate": "2026-02-10T11:36:02.00Z",
    "submitted": [
      {
        "field": "$.brandDetails.displayNames[0].name",
        "value": "Walmart (https://www.walmart.com)"
      }
    ],
    "compared": [],
    "expected": []
  }
}

DisplayNamesNameMustNotIncludeVulgarWord

Definition	Severity	API	Sample	Mode
Validate that name does not include a vulgar word

DisplayNamesNameLengthMustNotExceedMaximum

Definition	Severity	API	Sample	Mode
Validate that name length does not exceed a maximum value (255)			Link

DisplayNamesNameMustNotMatchBrandInSameCountry

Definition	Severity	API	Sample	Mode
Validate that each primary name (distinct locale) does not match any other Brand's name with the same countryCodes value			Link

Primary Flag

AtLeastOnePrimaryNameMustBePresent

Definition	Severity	API	Sample	Mode
Validate that at least one (1) primary is present

DisplayNamesPrimaryMustBePresent

Definition	Severity	API	Sample	Mode
Validate that primary is present			Link

MustHaveOnlyOnePrimaryNamePerLocale

Definition	Severity	API	Sample	Mode
Validate that no more than one (1) locale is primary