Skip to main content
CMS field keys come from the database schema in Plato CMS. Use the field key, not the display label, in API requests.

​
Text Fields

Non-localized text: 
{
  "values": {
    "sku": "BURGER-CLASSIC"
  }
}
Localized text: 
{
  "values": {
    "name": {
      "en": "Classic Burger",
      "ar": "Classic Burger"
    }
  }
}
If you send a plain string to a localized field, Plato stores it as English.

​
Numbers

Number, slider, and rating fields accept numeric values: 
{
  "values": {
    "price": 38,
    "rating": 4.5
  }
}

​
Booleans

Toggle fields and checkbox fields without options accept booleans: 
{
  "values": {
    "published": true
  }
}

​
Select And Multi-Select

Single select fields usually accept one option value: 
{
  "values": {
    "status": "published"
  }
}
Multi-select style fields accept an array: 
{
  "values": {
    "tags": ["featured", "summer"]
  }
}
Use stable option values from the CMS schema.

​
Dates And Times

Date and date-time fields are normalized to ISO strings. 
{
  "values": {
    "startsAt": "2026-06-17T10:00:00.000Z"
  }
}

​
JSON

JSON fields accept objects, arrays, numbers, strings, booleans, or null. 
{
  "values": {
    "metadata": {
      "source": "website",
      "featured": true
    }
  }
}
If you send JSON as a string, it must be valid JSON.

​
File And Image Fields

File and image fields store file references. For single-file fields, send one value: 
{
  "values": {
    "heroImage": "file_id_or_url"
  }
}
For multi-file fields, send an array: 
{
  "values": {
    "gallery": ["file_1", "file_2"]
  }
}

​
Empty Values

Use null or an empty string to clear most single-value fields. Multi-value fields become an empty array when cleared. Boolean fields become false when cleared.