Apple News Format

Get Apple News Format reference information, and create signature content for Apple News.


Apple News Format is the JavaScript Object Notation (JSON) format you use to create articles for Apple News.

An article created in Apple News Format can include text, images, audio, video, embedded social media, photo galleries, data tables, and interactive maps. You can enhance your article with animations, behaviors, and customized styles that let you create a unique look for your content. Your finished article is processed and rendered in Apple News.

With Apple News Format, you only have to author your content once. News automatically optimizes your articles for iPhone, iPad, iPod touch, and Mac to give your readers the best experience for their device.


First Steps

JSON Concepts and Article Structure

Understand basic JSON concepts and become familiar with the structure of an Apple News Format article.

Creating an Article: Main Steps

Plan the design for your article and create it in Apple News Format.

object ArticleDocument

The root object of an Apple News article, containing required properties, metadata, content, layout, and styles.

Article Display

Changing the Appearance of Your Article Tile in Feeds

Change the information that News displays about your published article.

Article Metadata

object Metadata

Information about your article, including author name, creation date, publication date, keywords, and excerpt.

object LinkedArticle

A relationship between your article and another Apple News article.

Article Layout

Planning the Layout for Your Article

Define a layout that supports the look you want for your article.

Positioning the Content in Your Article

Align article components with columns in your layout.

Wrapping Text Around a Component

Define the layout of a text component to wrap around another component.

object Layout

The object for defining columns, gutters, and margins for your article’s designed width.

object ComponentLayout

The object for defining the positioning for a specific component within the article’s column system.

object Anchor

The object for anchoring one component to another component in your article’s layout.

object Margin

The object for defining the space above and below a component.

object ContentInset

The object for defining the space around the component content on one or more sides.

object AdvertisingLayout

The object for defining the margin above and below advertising components.

Article Content


Understand the types of components that can make up an article.


Understanding Styles

Learn how to use Apple News Format styles to enhance the text and components in your article.

object DocumentStyle

The object for setting the background color for your article.

Text Styles

Learn about text styles and how to apply them to 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 specify the styling for tables.

Supported Color Names

See the color names supported in Apple News Format.

type Color

The strings for defining colors in Apple News Format.

Dynamic Advertising

Managing Advertisements in Your Article

Set the layout and frequency of advertisements automatically inserted in an article, and manually suggest specific locations for advertising content.

object AdvertisingSettings

The object for defining properties that affect the frequency and placement with which banner advertisements and medium rectangle advertisements are automatically placed in your article.

Featured Stories

Creating Articles for Featured Stories

Create articles with cover art to be considered for the Featured Stories section.

Getting Featured Stories Approved

Submit articles to be considered for the Featured Stories section in the For You feed.

object CoverArt

The object for specifying cover art that is required for an article to be considered for inclusion in the Featured Stories section.

Component Measurements and Media Guidelines

Specifying Measurements for Components

Specify the units of measure to use for margins, minimum heights, and other measurements.

Guidelines for Using Images, Videos, and Audio Files

Get the requirements and recommendations for using images and other media in your article.

type SupportedUnits

The units of measurement supported by Apple News Format.

See Also

Article Design and Creation

Apple News Format Tutorials

Create a basic article and then add advanced design features.

What’s New in Apple News Format

Check out new features and enhancements.