Guides and Sample Code

Developer

Apple News Format Reference

On This Page

Cover Art

Cover art allows you to provide additional cover artwork for an article for editorial consideration. The editorially-curated article shows up in the Featured Stories section of the For You feed. (See About Featured Stories.) Publish your articles with cover art and with isPreview set to true to preview them in your channel’s Drafts section. See Create Article in the Apple News API Reference for information about isPreview.

You can define cover art for an article by adding a coverArt array to the Article Metadata section of the article.json file.

You will need to provide additional cover artwork for this. The artwork must be a high resolution image that maintains at least one of the aspect ratios. The aspect ratio can be portrait (3:4 ratio), landscape (4:3 ratio), or square (1:1 ratio). And, there are aspect ratios for five device-optimized sizes. (See the table below.)

You must choose an aspect ratio from the table below, and provide artwork with the specifications listed for iPad Pro (12.9 in). As a best practice, also provide artwork at the specifications listed for iPhone (5.5 in). Optionally, you can also provide artwork for the other three dimensions listed. All sizes of your image should be for the same aspect ratio.

Use the following dimensions for device-optimized sizes:

Aspect Ratio

Device with required asset dimensions

Device with minimum recommended font size*

Portrait

iPhone (4 in): 354 x 472 px

iPhone (4.7 in): 414 x 552 px

iPhone (5.5 in): 687 x 916 px

iPad (7.9/9.7 in): 840 x 1120 px

iPad Pro (12.9 in): 1122 x 1496 px

iPhone (all sizes): 24 pt

iPad: 30 pt

iPad Pro: 36 pt

Landscape

iPhone (4 in): 536 x 402 px

iPhone (4.7 in): 632 x 474 px

iPhone (5.5 in): 1044 x 783 px

iPad (7.9/9.7 in): 1376 x 1032 px

iPad Pro (12.9 in): 1832 x 1374 px

iPhone (all sizes): 24 pt

iPad: 30 pt

iPad Pro: 36 pt

Square

iPhone (4 in): 470 x 470 px

iPhone (4.7 in): 550 x 550 px

iPhone (5.5 in): 912 x 912 px

iPad (7.9/9.7 in): 1104 x 1104 px

iPad Pro (12.9 in): 1472 x 1472 px

iPhone (all sizes): 24 pt

iPad: 30 pt

iPad Pro: 36 pt

*All values are provided based on a 72 px per inch document.

Additionally:

  • Include your logo on all images.

  • Make sure your logo does not exceed 50 percent of the total width of the artwork and is no more than 140 px tall.

  • Make sure any included text is related to the story headline.

  • Do not include additional promotional text, such as sponsor logos or URLs.

Required Properties

Use the below guidelines to reference coverArt in your article.json’s metadata section. See Article Metadata.

Property and type

Description

Version

type

String

The type of cover art provided. Currently, image is supported.

1.2

URL

String

The URL of the image file.

1.2

Optional Properties

Property and type

Description

Version

accessibilityCaption

String

A caption that describes the content of the cover image. Note that this property differs from caption : although the caption can be displayed to readers, the accessibilityCaption is used by VoiceOver for iOS only.

1.2

Cover Art Properties Example

  1. {
  2. "type": "image",
  3. "URL": "bundle://cover-image-ipad.jpg",
  4. "accessibilityCaption": "Magazine cover photo of Tim Cook"
  5. },
  6. {
  7. "type": "image",
  8. "URL": "bundle://cover-image-iphone.jpg",
  9. "accessibilityCaption": "Magazine cover photo of Tim Cook"
  10. }

About Featured Stories

Featured Stories is an article group in the For You feed of the News app. This group highlights stories that were created using Apple News Format and curated by Apple News editors. Supplying additional cover art is a requirement for the editorial team to consider an article for inclusion in the Featured Stories showcase.

For more information on Featured Stories and how they are editorially curated, see the News FAQ.

Cover Art in Featured Stories

This section shows you how cover art displays in the various devices for the three aspect ratios.

Portrait

image: ../Art/03_FeaturedStories_PublisherGuidelines_Portrait_2x.png

Landscape

image: ../Art/01_FeaturedStories_PublisherGuidelines_Landscape_2x.png

Square

image: ../Art/02_FeaturedStories_PublisherGuidelines_Square_2x.png

Previewing Featured Stories on Your Device

If an article contains cover art and is delivered with isPreview set to true, a special Featured Stories widget is unlocked on your device in your Drafts section. See Create Article in the Apple News API Reference for information about isPreview.

image: ../Art/MyChannelDrafts_2x.png