Apple News Composer Tutorial

In This Section

An Apple News message is a push notification that links to an Apple News Story. Learn more in the Composer Overview.

What You’ll Do

In this tutorial, you will:

  1. Enter your message’s content.
  2. Choose which Apple New Story the message will link to.
  3. Optionally select recipient countries.
  4. Preview and send the message.

Features and options are explained along the way.


  1. Choose your project from the Urban Airship dashboard, then click the Create button and select the Apple News composer.
  2. Enter the Push Notification Text you want to accompany the Apple News story, limited to 130 characters.
    The previewer on the right side of the screen updates as you compose your message. The Channel Name entered when setting up the service appears in bold.

  3. Click the Select a story button, then click to select from the list that appears. Story information displayed:

    • Title
    • Share URL: If the story has a canonical URL, it is displayed here instead of the share URL.
    • Status: Only Live or Processing stories may be selected. If an article is processing, the message will be sent when processing is complete. A story that was retracted cannot be selected.
  4. Optionally select recipient Countries. This defaults to All. Available countries are dependent on the selections made when setting up the service with Urban Airship, not necessarily the countries you have configured with Apple.

    Select the radio button for Choose, then click to make your selection from the list that appears. After your first selection, use the Select a country dropdown menu to add another country.
  5. Confirm the message appearance and content in the previewer.

  6. Send your message! Click the Send Now button at the bottom of your window. If the selected story is still processing, the button will instead be labeled Send When Live .

We validate the country selection when the Send Now button is clicked. If a country selected here is not configured in your Apple News publisher channel settings, you will see the error Country not available when attempting to send to that country. Edit country selection in Settings » Platforms.

Messages cannot be retracted or deleted.


Go to Messages » Apple News to see a year’s history of your Apple News messages.