Apple News Format

Create signature content for Apple News and understand the capabilities of Apple News Format.


Apple News Format is a document format that is expressed in JavaScript Object Notation (JSON). Use Apple News Format to create and publish articles with beautiful typography, rich photo galleries, videos, and fun animations that bring your content to life. You only have to author once because News automatically optimizes your content for iPhone, iPad, and iPod touch to give your readers the best experience for their device.


First Steps

Before You Start with Apple News Format

Review the basic concepts of Apple News Format JSON and learn about using HTML and Markdown in your JSON documents.

Creating Articles in Apple News Format

Learn the basic steps for creating an article.

Article Basics

Changing the Appearance of Your Article Tile in Feeds

Learn how to change the information that News displays about your published article.

object Article Document

Define the article document properties for your Apple News Format JSON file.

object Metadata

Supply information that describes different aspects of your article, including author name, creation date, publication date, keywords, excerpt, and so on.

object Linked Article

Define a link from your article.json document to another document within Apple News.

object Metadata.Campaign Data

Define custom key-value pairs for use in advertisement campaigns.

Article Layout

Planning the Layout for Your Article

Use a column system to define a layout that will support the look you want for your article.

Positioning Components in Your Article Layout

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, such as a pull quote or an image.

object Layout

Define the columns, width, and margins for your design.

object Component Layout

Define the positions for a specific component within the article's column system.

object Anchor

Anchor one component to another component in your layout.

object Margin

Set the spacing above and below a component.

object Content Inset

Add space around the component content on one or more sides.

object Advertising Layout

Set the spacing above and below a banner advertisement component.

Article Content


Understand the types and uses for the components that make up an article, and learn the basic steps for using components to add content to your article.


Understanding Styles

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

object Document Style

Set the background color for your article.

Text Styles and Effects

Learn about the different text styles and special text effects that can enhance your article 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 data tables.

Supported Color Names

See the color names supported in Apple News Format.

type Color

Define colors in Apple News Format.

Dynamic Advertising

Managing Advertisements in Your Article

Set the layout and frequency of advertisements automatically inserted in an article.

object Advertising Settings

Define the behavior of automatic insertion of Banner Advertisement or Medium Rectangle Advertisement 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 in News.

object Cover Art

Provide cover artwork for an article so it can be considered for inclusion in the Featured Stories section of the For You feed in News.

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 Supported Units

See the units of measurement supported by Apple News Format.

See Also

Design and Create

Understanding the Workflow for Creating an Article

View the workflow for creating articles in Apple News Format.

What’s New in Apple News Format

Check out new features and enhancements.

Apple News Format Tutorials

Create a basic article and then add advanced design features.