The object for setting the background color for your article.



The article’s background color. The value defaults to white.


An instance or array of document style properties that can be applied conditionally, and the conditions that cause them to be applied.


Use the DocumentStyle object to set the background color for the entire article.

This object can be used in ArticleDocument.


{ "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" } ]}

See Also


Enhancing Your Articles with Styles

Improve the appearance of the text and components in your article by using Apple News Format styles.

Text Styles

Learn about text styles and how to apply them to your text and text components.

Component Styles

Learn to use component styles to add borders, set background colors, and apply background images to components and to set the styling for tables.

Supported Color Names

Learn the color names supported in Apple News Format.

type Color

The strings for defining colors in Apple News Format.