<!--
{
  "availability" : [
    "Apple News Format: 1.7.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppleNewsFormat",
  "identifier" : "/documentation/AppleNewsFormat/DataDescriptor",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple News Format"
    ],
    "preciseIdentifier" : "data:news_format:DataDescriptor"
  },
  "title" : "DataDescriptor"
}
-->

# DataDescriptor

The object for providing the data type, data formatting, and label for a field in a table.

```
object DataDescriptor
```

## Discussion

A `DataDescriptor` object defines the data in a table by including basic information such as data type, data format, and a name for this set of data that identifies the kind of information it is. For example, the name could be “product number” or “release year”. An array of all the data descriptors for a table is located in the table’s [`RecordStore`](/documentation/AppleNewsFormat/RecordStore).

### Example

```json
{
  "components": [
    {
      "role": "datatable",
      "showDescriptorLabels": true,
      "sortBy": [
        {
          "descriptor": "id-name",
          "direction": "descending"
        }
      ],
      "data": {
        "descriptors": [
          {
            "identifier": "id-image",
            "key": "image",
            "label": {
              "type": "formatted_text",
              "text": "Image"
            },
            "format": {
              "type": "image",
              "maximumWidth": "50pt"
            },
            "dataType": "image"
          },
          {
            "identifier": "id-name",
            "key": "name",
            "label": {
              "type": "formatted_text",
              "text": "Name"
            },
            "dataType": "string"
          },
          {
            "identifier": "id-occupation",
            "key": "occupation",
            "label": "Occupation",
            "dataType": "string"
          }
        ],
        "records": [
          {
            "image": "bundle://image-1.jpg",
            "name": "Amelia Earhart",
            "occupation": "Pilot"
          },
          {
            "image": "bundle://image-2.jpg",
            "name": "Grace Hopper",
            "occupation": "Computer Scientist"
          }
        ]
      }
    }
  ]
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)