Attribute data formats

The Product Catalog supports multiple attribute data formats for predefined and custom attributes.

Custom attributes can be configured with different data formats depending on the expected data structure and use case. Predefined attributes use fixed data formats that cannot be changed.

Available data formats for custom attributes

Custom attributes can use the following data formats.

Text

Free-form text value.

"This is Text"

Number

Numeric value. Both integers and decimal numbers are supported.

123
123.23

Boolean

Boolean value. Use true or false.

true

List

List of values.

[
  "red",
  "white",
  "blue"
]

Localized text

Text values with locale country codes based on ISO 3166-1.

{
  "GB": "car",
  "DE": "auto"
}

Localized number

Numeric values with locale country codes based on ISO 3166-1.

{
  "GB": 123,
  "DE": 345
}

Localized list

Lists of values with locale country codes based on ISO 3166-1.

{
  "GB": [
    "red",
    "white"
  ],
  "DE": [
    "rot",
    "weiß"
  ]
}

Predefined attribute formats

Predefined attributes use fixed data formats that cannot be changed.

Text

The following predefined attributes use the Text format:

• Variant ID

• Product ID

• Style ID

• Style Title

• Variant Title

• Brand

• GTIN

• MPN

"This is title"

Currency

The Currency attribute uses localized text.

Use ISO 3166-1 alpha-2 country codes as keys and ISO 4217 currency codes as values.

{
  "US": "USD",
  "GB": "GBP"
}

Localized text

The following predefined attributes use localized text with BCP 47 language tags as keys and strings as values:

• Product Title

• Product Description

• Color

• PDP URL

{
  "en-GB": "Light dress",
  "de-DE": "Leichtes Kleid"
}

Size

The Size attribute uses localized text.

Use ISO 3166-1 alpha-2 country codes as keys and strings as values.

{
  "US": "S",
  "GB": "8"
}

Image URL

The Image URL attribute uses the List format.

[
  "http://link1.com",
  "http://link2.com"
]

Price

The Price attribute uses localized numbers.

Use ISO 3166-1 alpha-2 country codes as keys and numbers as values.

{
  "US": 29.99,
  "GB": 24.99
}

Variant Status

The Variant Status attribute uses a numeric enum.

1

Fashion-enabled attribute formats

Additional predefined attributes are available for enrich-ready fashion feeds.

Boolean

The following fashion-enabled attributes use the Boolean format:

• Seasonal

• Multipack

true

Text

The following fashion-enabled attributes use the Text format:

• Material

• Set ID

• EAN

• Ancillary Product Code

• Best Model Image

• Best Product Image

"cotton"

Number

The following fashion-enabled attributes use the Number format:

• Min Age

• Max Age

18

Old Price

The Old Price attribute uses localized numbers.

Use ISO 3166-1 alpha-2 country codes as keys and numbers as values.

{
  "US": 29.99,
  "GB": 24.99
}

Extra ID

The Extra ID attribute uses localized text.

Use ISO 3166-1 alpha-2 country codes as keys and strings as values.

{
  "US": "abc",
  "GB": "cde"
}

Locale

The Locale attribute uses the List format.

[
  "en-GB",
  "de-DE"
]

Localized data formats

Localized formats use locale-specific keys to store values for different languages or regions.

Localized text example

{
  "en": "Summer Dress",
  "de": "Sommerkleid"
}

Localized number example

{
  "en-GB": 49.99,
  "de-DE": 54.99
}

Localized list example

{
  "en": [
    "Summer",
    "Sale"
  ],
  "de": [
    "Sommer",
    "Angebot"
  ]
}

Locale validation

Localized formats are validated against supported international standards.