---
title: DocumentStyle
framework: applenewsformat
role: symbol
role_heading: Object
path: applenewsformat/documentstyle
---

# DocumentStyle

The object for setting the background color for your article.

## Declaration

```data
object DocumentStyle
```

## Properties

backgroundColor: The article’s background color. The value defaults to white. conditional: An instance or array of document style properties that you can apply conditionally, and the conditions that cause Apple News to apply them.

## Mentioned in

Supporting Dark Mode for Your Article

## Discussion

Discussion Use the DocumentStyle object to set the background color for the entire article. You can use this object in ArticleDocument. Example {   "documentStyle": {     "backgroundColor": "#F7F7F7"   },   "components": [     {       "role": "title",       "text": "Apple News Format"     },     {       "role": "body",       "text": "Apple News Format allows publishers to craft beautiful editorial layouts. Galleries, audio, video, and fun interactions like animation make stories spring to life."     },     {       "role": "photo",       "URL": "bundle://image.jpg"     }   ] }

## Relationships

### Inherited By

- [ConditionalDocumentStyle](applenewsformat/conditionaldocumentstyle.md)

## See Also

### Styles

- [Enhancing Your Articles with Styles](applenews/enhancing-your-articles-with-styles.md)
- [Supporting Dark Mode for Your Article](applenews/supporting-dark-mode-for-your-article.md)
- [Text Styles](applenews/text-styles.md)
- [Component Styles](applenews/component-styles.md)
- [Supported Color Names](applenews/supported-color-names.md)
- [Color](applenewsformat/color.md)