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

# ArticleDocument.componentTextStyles

An object containing component text style defaults as well as component text styles that components in the article can use.

```
object ArticleDocument.componentTextStyles
```

## Discussion

`ArticleDocument.componentTextStyles` is an object containing the component text style defaults as well as component text style objects that components in your article can use. You provide each component text style object as a key-value pair. The value of each pair is a [`ComponentTextStyle`](/documentation/AppleNewsFormat/ComponentTextStyle) object.

**To create a default style for the entire article**, use the key `"default"`. Apple News automatically applies this style to all text components.

**To create a default style for all body components**, use the key `"default-body"`. Apple News automatically applies this style  to all `body` components, after it applies the default style. If a property is in both `default-body` and `default`, the value in `default-body` overrides the property in `default`. This works for all components that inherit properties from [`Text`](/documentation/AppleNewsFormat/Text), including [`Body`](/documentation/AppleNewsFormat/Body), [`Title`](/documentation/AppleNewsFormat/Title), and [`Heading`](/documentation/AppleNewsFormat/Heading).

**To create a style for components to refer to**, create a key that’s meaningful to you. Apple News applies this style  to any components that refer to it, after it applies the default styles. If a property is in both the referenced style and one of the defaults, the property in the referenced style overrides the defaults.

### Example

```json
{
  "title": "Article Title",
  "identifier": "sample",
  "version": "1.8",
  "language": "en",
  "layout": {
    "columns": 20,
    "width": 1024,
    "margin": 60,
    "gutter": 20
  },
  "documentStyle": {
    "backgroundColor": "#FFF"
  },
  "components": [
    {
      "role": "section",
      "components": [
        {
          "role": "body",
          "format": "html",
          "textStyle": "exampleStyle",
          "text": "<p>There is a moment in every dawn when light floats, there is the possibility of magic.</p>"
        }
      ]
    }
  ],
  "componentTextStyles": {
    "default": {
      "fontName": "Courier",
      "textColor": "#000",
      "fontSize": 22,
      "lineHeight": 20,
      "linkStyle": {
        "textColor": "#000",
        "underline": false
      },
      "hyphenation": false
    },
    "exampleStyle": {
      "fontFamily": "Gill Sans",
      "fontWeight": "bolder",
      "textColor": "#333333",
      "fontSize": 18,
      "textShadow": {
        "radius": 20,
        "opacity": 0.3,
        "color": "#99999930",
        "offset": {
          "x": -10,
          "y": 5
        }
      },
      "stroke": {
        "color": "#FFC800",
        "width": 1
      }
    }
  },
  "textStyles": {},
  "componentStyles": {},
  "componentLayouts": {}
}
```

---

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)