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

# DropCapStyle

The object for defining the drop cap text style to use in the first paragraph in a text component.

```
object DropCapStyle
```

## Discussion

Use a `DropCapStyle` object to define a drop cap that a [`ComponentTextStyle`](/documentation/AppleNewsFormat/ComponentTextStyle) object can use. You can apply drop caps to the first paragraph of the following components:

- [`Author`](/documentation/AppleNewsFormat/Author)
- [`Body`](/documentation/AppleNewsFormat/Body)
- [`Byline`](/documentation/AppleNewsFormat/Byline)
- [`Caption`](/documentation/AppleNewsFormat/Caption)
- [`Heading`](/documentation/AppleNewsFormat/Heading)
- [`Illustrator`](/documentation/AppleNewsFormat/Illustrator)
- [`Intro`](/documentation/AppleNewsFormat/Intro)
- [`Photographer`](/documentation/AppleNewsFormat/Photographer)
- [`PullQuote`](/documentation/AppleNewsFormat/PullQuote)

> Note:
> Using a divider between paragraphs splits text into separate components. This affects the rendering of `dropCapStyle`. If you want to include a divider between paragraphs and you don’t want the paragraph after the divider to have a drop cap, use separate text components for the block of text before and after the divider. Then make sure that you don’t have `dropCapStyle` in the text component following the divider.

You can use this object in [`TextStyle`](/documentation/AppleNewsFormat/TextStyle) and [`ComponentTextStyle`](/documentation/AppleNewsFormat/ComponentTextStyle).

### Example

```json
{
  "componentTextStyles": {
    "exampleStyle": {
      "fontName": "HelveticaNeue",
      "fontSize": 20,
      "dropCapStyle": {
        "numberOfLines": 5,
        "numberOfRaisedLines": 2,
        "numberOfCharacters": 1,
        "fontName": "HelveticaNeue",
        "textColor": "#FFF",
        "backgroundColor": "#000",
        "padding": 5
      }
    }
  }
}
```

---

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)