<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "AppleNews",
  "identifier" : "/documentation/AppleNewsFormat",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service",
  "symbol" : {
    "kind" : "Web Service",
    "modules" : [
      "Apple News Format"
    ],
    "preciseIdentifier" : "AppleNewsFormat"
  },
  "title" : "Apple News Format"
}
-->

# Apple News Format

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

## Overview

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.

![Screenshot of an Apple News article on iPad.](images/com.apple.applenews/media-3596705~dark@2x.png)

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

## Topics

### Release Notes

Release notes announce new features, updates, and deprecations for major and beta releases, so you can plan for changes and make adjustments as needed.

  <doc://com.apple.applenews/documentation/AppleNews/apple-news-format-release-notes>

  <doc://com.apple.applenews/documentation/AppleNews/apple-news-format-version-history>

### Essentials

  <doc://com.apple.applenews/documentation/AppleNews/json-concepts-and-article-structure>

  <doc://com.apple.applenews/documentation/AppleNews/creating-an-article-main-steps>

[`ArticleDocument`](/documentation/AppleNewsFormat/ArticleDocument)

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

### Article Display

  <doc://com.apple.applenews/documentation/AppleNews/changing-the-appearance-of-your-article-tile-in-feeds>

### Article Metadata

[`Metadata`](/documentation/AppleNewsFormat/Metadata)

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

[`LinkedArticle`](/documentation/AppleNewsFormat/LinkedArticle)

A relationship between your article and another Apple News article.

[`Issue`](/documentation/AppleNewsFormat/Issue)

The object for defining information about an issue.

### Article Layout

  <doc://com.apple.applenews/documentation/AppleNews/planning-the-layout-for-your-article>

  <doc://com.apple.applenews/documentation/AppleNews/positioning-the-content-in-your-article>

  <doc://com.apple.applenews/documentation/AppleNews/wrapping-text-around-a-component>

[`Layout`](/documentation/AppleNewsFormat/Layout)

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

[`ComponentLayout`](/documentation/AppleNewsFormat/ComponentLayout)

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

[`Anchor`](/documentation/AppleNewsFormat/Anchor)

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

[`Margin`](/documentation/AppleNewsFormat/Margin)

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

[`AutoPlacementLayout`](/documentation/AppleNewsFormat/AutoPlacementLayout)

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

[`AdvertisingLayout`](/documentation/AppleNewsFormat/AdvertisingLayout)

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

### Article Content

  <doc://com.apple.applenews/documentation/AppleNews/components>

### Styles

  <doc://com.apple.applenews/documentation/AppleNews/enhancing-your-articles-with-styles>

  <doc://com.apple.applenews/documentation/AppleNews/supporting-dark-mode-for-your-article>

[`DocumentStyle`](/documentation/AppleNewsFormat/DocumentStyle)

The object for setting the background color for your article.

  <doc://com.apple.applenews/documentation/AppleNews/text-styles>

  <doc://com.apple.applenews/documentation/AppleNews/component-styles>

  <doc://com.apple.applenews/documentation/AppleNews/supported-color-names>

[`Color`](/documentation/AppleNewsFormat/Color)

The strings for defining colors in Apple News Format.

### Dynamic Advertising

  <doc://com.apple.applenews/documentation/AppleNews/managing-advertisements-in-your-channel>

[`AutoPlacement`](/documentation/AppleNewsFormat/AutoPlacement)

The object for automatically placing components within Apple News Format articles.

[`AdvertisementAutoPlacement`](/documentation/AppleNewsFormat/AdvertisementAutoPlacement)

The object for defining the automatic placement of advertisements.

[`AdvertisingSettings`](/documentation/AppleNewsFormat/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.

### Conditional Design Elements

Define conditions for various objects to get the right look for your content.

[`Condition`](/documentation/AppleNewsFormat/Condition)

The object for defining a condition that, when met, causes conditional properties to go into effect.

[`ConditionalComponent`](/documentation/AppleNewsFormat/ConditionalComponent)

The object for defining conditional properties for a component, and when the conditional properties are in effect.

[`ConditionalComponentLayout`](/documentation/AppleNewsFormat/ConditionalComponentLayout)

The object for defining conditional properties for a component layout, and when the conditional properties are in effect.

[`ConditionalAutoPlacement`](/documentation/AppleNewsFormat/ConditionalAutoPlacement)

The object for defining conditional properties for an automatically placed component, and when the conditional properties are in effect.

[`ConditionalSection`](/documentation/AppleNewsFormat/ConditionalSection)

The object for defining conditional properties for a section component, and when the conditional properties are in effect.

[`ConditionalDocumentStyle`](/documentation/AppleNewsFormat/ConditionalDocumentStyle)

The object for defining conditional properties for a document style, and when the conditional properties are in effect.

[`ConditionalText`](/documentation/AppleNewsFormat/ConditionalText)

The object for defining conditional properties for a text component, and when the conditional properties are in effect.

[`ConditionalTextStyle`](/documentation/AppleNewsFormat/ConditionalTextStyle)

The object for defining conditional properties for a text style, and when the conditional properties are in effect.

[`ConditionalComponentTextStyle`](/documentation/AppleNewsFormat/ConditionalComponentTextStyle)

The object for defining conditional properties for a component text style, and when the conditional properties are in effect.

[`ConditionalComponentStyle`](/documentation/AppleNewsFormat/ConditionalComponentStyle)

The object for defining conditional properties for a component style, and when the conditional properties are in effect.

[`ConditionalContainer`](/documentation/AppleNewsFormat/ConditionalContainer)

The object for defining conditional properties for a container component, and when the conditional properties are in effect.

[`ConditionalDivider`](/documentation/AppleNewsFormat/ConditionalDivider)

The object for defining conditional properties for a divider component, and when the conditional properties are in effect.

[`ConditionalButton`](/documentation/AppleNewsFormat/ConditionalButton)

The object for defining a button component’s conditional properties, and when the conditional properties are in effect.

### Component Measurements and Media Guidelines

  <doc://com.apple.applenews/documentation/AppleNews/specifying-measurements-for-components>

[`SupportedUnits`](/documentation/AppleNewsFormat/SupportedUnits)

The units of measurement Apple News Format supports.

  <doc://com.apple.applenews/documentation/AppleNews/preparing-image-video-audio-music-and-arkit-assets>


---

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)