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

# FormattedText

The object for specifying formatted text content and styling for captions in table cells.

```
object FormattedText
```

## Discussion

Use a `FormattedText` object to provide the content and style for text strings you use in data tables and as caption descriptors. You can use a `FormattedText` object for:

- Row and column headers (the value of the `label` property in [`DataDescriptor`](/documentation/AppleNewsFormat/DataDescriptor))
- Data in JSON tables (the value of a key-value pair in a record in [`RecordStore`](/documentation/AppleNewsFormat/RecordStore))

To apply a style to a `FormattedText` object, you can use a [`ComponentTextStyle`](/documentation/AppleNewsFormat/ComponentTextStyle). You can also use either HTML or [`InlineTextStyle`](/documentation/AppleNewsFormat/InlineTextStyle) objects to further customize ranges of text. See <doc://com.apple.applenews/documentation/AppleNews/using-html-with-apple-news-format>.

> Note:
> `FormattedText` objects don’t support Markdown syntax.

You can use this object in [`DataDescriptor`](/documentation/AppleNewsFormat/DataDescriptor), [`RecordStore`](/documentation/AppleNewsFormat/RecordStore), and [`CaptionDescriptor`](/documentation/AppleNewsFormat/CaptionDescriptor).

### Example

```json
{
  "components": [
    {
      "role": "datatable",
      "data": {
        "descriptors": [
          {
            "identifier": "id-title",
            "key": "title",
            "dataType": "text",
            "label": "Title"
          }
        ],
        "records": [
          {
            "title": {
              "type": "formatted_text",
              "text": "<strong>Name</strong>",
              "format": "html"
            }
          }
        ]
      }
    }
  ]
}
```

---

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)