Skip to main content

Showcase creative content validation rules for descriptions, locale requirements, placement types, and text constraints

Contents​

ContentsMustBePresent​

DefinitionSeverityAPISampleMode
Validates that contents is present
VIOLATION
POST_AND_PUT
Link
S

Descriptions​

DescriptionsMustBePresent​

DefinitionSeverityAPISampleMode
Validates that descriptions is present
VIOLATION
POST_AND_PUT
Link
S

DescriptionsAndPhotoLocaleShouldMatch​

Preconditions
Photo captions are present
DefinitionSeverityAPISampleMode
Validate that at least one (1) Descriptions locale matches locale in captions
WARNING
POST_AND_PUT
Link
S

HeadlineDescriptionsTextMatchesBodyDescriptionsText​

Preconditions
HEADLINE descriptions locale matches BODY descriptions locale
DefinitionSeverityAPISampleMode
Validate that HEADLINE descriptions text does not match BODY descriptions text
VIOLATION
POST_AND_PUT
S
Example Validation Report
{
  "code": "VALIDATION__HeadlineDescriptionsTextMatchesBodyDescriptionsText",
  "severity": "VIOLATION",
  "message": "`HEADLINE` descriptions `text` matches `BODY` descriptions `text`",
  "details": {
    "createdDate": "2026-12-01T21:00:59.865Z",
    "submitted": [
      {
        "field": "$.showcaseCreativeDetails.contents[0].descriptions[0].text",
        "value": "Happy New Year!"
      },
      {
        "field": "$.showcaseCreativeDetails.contents[1].descriptions[0].text",
        "value": "Happy New Year!"
      }
    ],
    "compared": [],
    "expected": []
  }
}

Locale​

DescriptionsLocaleMustBePresent​

DefinitionSeverityAPISampleMode
Validate that locale is present
VIOLATION
POST_AND_PUT
Link
S

DescriptionsLocaleMustBeValid​

DefinitionSeverityAPISampleMode
Validate that locale is valid
VIOLATION
POST_AND_PUT
Link
S

DescriptionsLocaleMustNotBeEmpty​

DefinitionSeverityAPISampleMode
Validate that locale is not an empty string
VIOLATION
POST_AND_PUT
S

BodyDescriptionsLocaleMustBeDistinct​

DefinitionSeverityAPISampleMode
Validate that each locale is distinct
VIOLATION
POST_AND_PUT
S

HeadlineDescriptionsLocaleMustBeDistinct​

DefinitionSeverityAPISampleMode
Validate that each locale is distinct
VIOLATION
POST_AND_PUT
S

Placement​

ContentsPlacementMustBePresent​

DefinitionSeverityAPISampleMode
Validates that placement is present
VIOLATION
POST_AND_PUT
Link
S

ContentsPlacementBodyMustBePresent​

DefinitionSeverityAPISampleMode
Validates that BODY Placement is present
VIOLATION
POST_AND_PUT
Link
S

ContentsPlacementHeadlineMustBePresent​

DefinitionSeverityAPISampleMode
Validates that HEADLINE Placement is present
VIOLATION
POST_AND_PUT
Link
S

ContentsPlacementMustNotBeEmpty​

DefinitionSeverityAPISampleMode
Validate that placement is not an empty string
VIOLATION
POST_AND_PUT
S

MustHaveExactlyOnePlacementBody​

DefinitionSeverityAPISampleMode
Validate that exactly one (1) BODY Placement is present
VIOLATION
POST_AND_PUT
S

MustHaveExactlyOnePlacementHeadline​

DefinitionSeverityAPISampleMode
Validate that exactly one (1) HEADLINE Placement is present
VIOLATION
POST_AND_PUT
S

PlacementTypesMustBePresent​

DefinitionSeverityAPISampleMode
Validates that both BODY and HEADLINE placement types are present
VIOLATION
POST_AND_PUT
S

Text​

ContentsDescriptionsTextHasUnsupportedCharacter​

DefinitionSeverityAPISampleMode
Validate that text does not include an unsupported character
VIOLATION
POST_AND_PUT
Link
S

DescriptionsTextMustBePresent​

DefinitionSeverityAPISampleMode
Validate that text is present
VIOLATION
POST_AND_PUT
Link
S

DescriptionsTextMustNotBeEmpty​

DefinitionSeverityAPISampleMode
Validate that text is not an empty string
VIOLATION
POST_AND_PUT
S

DescriptionsTextMustNotBeEntirelyNumeric​

DefinitionSeverityAPISampleMode
Validate that the text value is not entirely numeric
VIOLATION
POST_AND_PUT
S

DescriptionsBodyTextMustNotExceedMaximum​

DefinitionSeverityAPISampleMode
Validate that text length does not exceed a maximum value (100)
VIOLATION
POST_AND_PUT
S

DescriptionsHeadlineTextMustNotExceedMaximum​

DefinitionSeverityAPISampleMode
Validate that text length does not exceed a maximum value (38)
VIOLATION
POST_AND_PUT
S

DescriptionsTextMustExceedMinimum​

DefinitionSeverityAPISampleMode
Validate that text length exceeds a minimum value (5)
VIOLATION
POST_AND_PUT
S

DescriptionsTextMustNotIncludeVulgarWord​

DefinitionSeverityAPISampleMode
Validate that text does not include a vulgar word
WARNING
POST_AND_PUT
A

DescriptionsTextMustNotIncludeUrl​

DefinitionSeverityAPISampleMode
Validate that text does not include a URL
VIOLATION
POST_AND_PUT
Link
S

DescriptionsTextShouldNotMatch​

DefinitionSeverityAPISampleMode
Validate that text does not match among different locale values
WARNING
POST_AND_PUT
S

DescriptionsText_SuspectedUnintentionalSequentialWordRepetition​

DefinitionSeverityAPISampleMode
Validate that text does not include an unintentional repetitive sequence of words
WARNING
POST_AND_PUT
S

DescriptionsLocaleAmongDifferentPlacementsMustMatch​

DefinitionSeverityAPISampleMode
Validate that each Descriptions locale, listed under one Placement is matched by a Descriptions locale under each other Placement
VIOLATION
POST_AND_PUT
Link
S

ShowcaseCreativeInappropriateWordRejection​

DefinitionSeverityAPISampleMode
Validate that text does not include an inappropriate word
VIOLATION
POST_AND_PUT
A
Example Validation Report
{
  "code": "VALIDATION__ShowcaseCreativeInappropriateWordRejection",
  "severity": "VIOLATION",
  "message": "Showcase creative rejected for reason:'{{reason}}'",
  "context": {
    "reason": "`HEADLINE` value `Go to hell!` is not appropriate. In the context of hot sauce which is present in the `BODY` text, this is acceptable."
  },
  "details": {
    "createdDate": "2026-02-10T11:36:02.00Z",
    "submitted": [
      {
        "field": "$.showcaseCreativeDetails.contents[0].descriptions[0].text",
        "value": "Go to hell!"
      }
    ],
    "compared": [],
    "expected": []
  }
}
Copyright © 2026 Apple Inc. All rights reserved.