---
title: "Attribute data formats"
slug: "product-catalog-api-attribute-data-formats"
updated: 2026-05-29T13:47:31Z
published: 2026-05-29T13:47:31Z
canonical: "docs.mapp.com/product-catalog-api-attribute-data-formats"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```json
"This is Text"
```

### Number

Numeric value. Both integers and decimal numbers are supported.

```json
123
123.23
```

### Boolean

Boolean value. Use `true` or `false`.

```json
true
```

### List

List of values.

```json
[
  "red",
  "white",
  "blue"
]
```

### Localized text

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

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

### Localized number

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

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

### Localized list

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

```json
{
  "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

```json
"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.

```json
{
  "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

```json
{
  "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.

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

### Image URL

The `Image URL` attribute uses the `List` format.

```json
[
  "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.

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

### Variant Status

The `Variant Status` attribute uses a numeric enum.

| Value | Status |
| --- | --- |
| `0` | `pre_order` |
| `1` | `active` |
| `2` | `discontinued` |

```json
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

```json
true
```

### Text

The following fashion-enabled attributes use the `Text` format:

- Material
- Set ID
- EAN
- Ancillary Product Code
- Best Model Image
- Best Product Image

```json
"cotton"
```

### Number

The following fashion-enabled attributes use the `Number` format:

- Min Age
- Max Age

```json
18
```

### Old Price

The `Old Price` attribute uses localized numbers.

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

```json
{
  "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.

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

### Locale

The `Locale` attribute uses the `List` format.

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

---

## Localized data formats

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

### Localized text example

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

### Localized number example

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

### Localized list example

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

---

## Locale validation

Localized formats are validated against supported international standards.

| Standard | Purpose |
| --- | --- |
| `ISO 639-1` | Language codes. |
| `ISO 3166-1` | Country codes. |
| `ISO 4217` | Currency codes. |
| `BCP 47` | `ISO 639-1` language code + `ISO 3166-1` country code. Format: `language-COUNTRY`. Example: `de-DE`. |