Skip to main content

Contest display name validation rules for length, locales, primary flags, and content requirements

note

Additional precondition for all listed validations:

  • $.contestDetails.value.displayNames is present

Cross-feature​

LocationPrimaryDisplayNamesNameNotMatched​

Preconditions
Apple Business portal user
orgId resolves to organization that is location owner
Brand Preferences: Allow Location Name Override = NO, Cascade Name = AS_PRIMARY
Location and brand primary display name primary language tags match
Business type is any
DefinitionSeverityAPISampleMode
Validate that the location primary display name exactly matches a brand primary display name
VIOLATION
POST
S

LocationPrimaryDisplayNamesNameNotMatchedWithBrandName​

Preconditions
Not a Apple Business portal user
orgId resolves to organization that is location owner
Brand Preferences: Allow Location Name Override = NO, Cascade Name = AS_PRIMARY
Location and brand primary display name primary language tags match
Business type is any
DefinitionSeverityAPISampleMode
Validate that the location primary display name exactly matches a brand primary display name
WARNING
POST
Link
S

Display Names​

CountOfValuesInDisplayNamesListExceedsThreshold​

DefinitionSeverityAPISampleMode
Validate that the count of displayNames values in a list does not exceed one hundred seventy-eight (178)
VIOLATION
POST
S

DisplayNamesListMustNotIncludeNulls​

DefinitionSeverityAPISampleMode
Validate that a list does not include null
VIOLATION
POST
S

DisplayNamesMustBePresent​

DefinitionSeverityAPISampleMode
Validate that displayNames are present
VIOLATION
POST
Link
S

DisplayNamesMustNotBeEmptyArray​

DefinitionSeverityAPISampleMode
Validate that displayNames is not an empty array
VIOLATION
POST
S

Locale​

DisplayNamesIncludesUnsupportedLocale​

DefinitionSeverityAPISampleMode
Validate that an unsupported locale value is not present
WARNING
POST
S

DisplayNamesLocaleMustBeValid​

DefinitionSeverityAPISampleMode
Validate that locale is valid
VIOLATION
POST
Link
S

DisplayNamesLocaleMustBePresent​

DefinitionSeverityAPISampleMode
Validate that locale is present
VIOLATION
POST
Link
S

DisplayNamesLocaleMustBeDistinct​

Preconditions
Display Names name values match
DefinitionSeverityAPISampleMode
Validate that each locale is distinct
VIOLATION
POST
Link
S

DisplayNamesLocaleMustNotBeEmpty​

DefinitionSeverityAPISampleMode
Validate that locale is not an empty string
VIOLATION
POST
Link
S

DisplayNamesRequiresAtLeastOneSupportedLocale​

DefinitionSeverityAPISampleMode
Validate that at least one (1) supported locale is present
VIOLATION
POST
S

MustHaveOnlyOnePrimaryNamePerLocale​

DefinitionSeverityAPISampleMode
Validate that no more than one (1) locale is primary
VIOLATION
POST
S

Name​

DisplayNamesNameIsEntirelyNumeric​

DefinitionSeverityAPISampleMode
Validate that the name value is not entirely numeric
INFO
POST
S

DisplayNamesNameMustNotBeDummyCharacters​

DefinitionSeverityAPISampleMode
Validate that name is not exclusively dummy characters
VIOLATION
POST
Link
S

DisplayNamesNameHasSuspectedPresenceOfDummyCharacters​

DefinitionSeverityAPISampleMode
Validate that name does not include dummy characters
WARNING
POST
Link
S

DisplayNamesNameMustNotExceedMaximum​

DefinitionSeverityAPISampleMode
Validate that name length does not exceed a maximum value (255)
VIOLATION
POST
S

DisplayNamesNameMustBePresent​

DefinitionSeverityAPISampleMode
Validate that name is present
VIOLATION
POST
Link
S

DisplayNamesNameMustNotBeEmpty​

DefinitionSeverityAPISampleMode
Validate that name is not an empty string
VIOLATION
POST
S

DisplayNamesNameMustNotIncludeURL​

DefinitionSeverityAPISampleMode
Validate that name does not include a URL
VIOLATION
POST
Link
S

DisplayNamesIncludesNounSynonymousWithOperations​

DefinitionSeverityAPISampleMode
Validate that name does not include a noun (synonym) suspected to indicate the operating purpose of the location
INFO
POST
S

DisplayNamesNameHasSuspectedNounSynonymousWithOperations​

DefinitionSeverityAPISampleMode
name is noun (synonym) indicating the operational purpose of the location
WARNING
POST
Link
S

DisplayNamesNameIsAllLowerCase​

Preconditions
Name is at least three (3) alpha characters in length (excluding white space)
DefinitionSeverityAPISampleMode
Validate that name is not entirely lower case
INFO
POST
A

DisplayNamesNameIsAllUpperCase​

Preconditions
Name is at least three (3) alpha characters in length (excluding white space)
DefinitionSeverityAPISampleMode
Validate that name is not entirely upper case
INFO
POST
A

DisplayNamesNameMustNotIncludeVulgarWord​

DefinitionSeverityAPISampleMode
Validate that name does not include a vulgar word
VIOLATION
POST
A

DisplayNamesNameHasSuspectedUnintentionalSequentialWordRepetition​

DefinitionSeverityAPISampleMode
Validate that name does not include an unintentional repetitive sequence of words
WARNING
POST
Link
S

DisplayNamesNameHasUnsupportedCharacter​

DefinitionSeverityAPISampleMode
Validate that name does not include an unsupported character
VIOLATION
POST
Link
S

Primary​

AtLeastOnePrimaryNameMustBePresent​

DefinitionSeverityAPISampleMode
Validate that at least one (1) primary is present
VIOLATION
POST
S

DisplayNamesPrimaryFlagMustBePresent​

DefinitionSeverityAPISampleMode
Validate that primary is present
VIOLATION
POST
Link
S

Pronunciation​

DisplayNamesPronunciationMustNotBeDummyCharacters​

DefinitionSeverityAPISampleMode
Validate that pronunciation is not exclusively dummy characters
VIOLATION
POST
Link
S

DisplayNamesPronunciationMustNotBeEmpty​

DefinitionSeverityAPISampleMode
Validate that pronunciation is not an empty string
VIOLATION
POST
S

DisplayNamesPronunciationMustNotBeEntirelyNumeric​

DefinitionSeverityAPISampleMode
Validate that the pronunciation value is not entirely numeric
VIOLATION
POST
S

DisplayNamesPronunciationMustNotExceedMaximum​

DefinitionSeverityAPISampleMode
Validate that pronunciation length does not exceed a maximum value (255)
VIOLATION
POST
S

DisplayNamesPronunciationMustExceedMinimum​

DefinitionSeverityAPISampleMode
Validate that pronunciation length exceeds a minimum value (5)
VIOLATION
POST
S

DisplayNamesPronunciationMustNotIncludeVulgarWord​

DefinitionSeverityAPISampleMode
Validate that pronunciation does not include a vulgar word
VIOLATION
POST
A
Copyright © 2026 Apple Inc. All rights reserved.