Promote, edit, delete, or hide articles in News Publisher

You can promote up to six published articles per section so that they move to the top of the section in your News channel.

To be promoted, CMS or hand-coded articles must contain a thumbnail image. Articles created in News Publisher must contain at least one image.

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, click the section name in the sidebar, then click next to an article title.

3. Repeat step 2 for up to five more articles.

   If you promote a seventh article, it moves to the top of the list of promoted articles, the next five articles move to the second-through-sixth spots, and the last article disappears from the list (but remains in your regular feed).

If your channel is available in multiple territories, you can change the territories in which an article appears.

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Click next to an article title, choose territories, then click Done.

The method by which you edit articles depends on how they were created.

• Articles you hand coded or created in a CMS: Can be edited in your CMS or you can upload an updated hand-coded version. See Update an article (CMS and hand-coded articles only).

• Articles created in News Publisher: Must be edited in News Publisher. See Edit articles created in News Publisher.

When you update an article, the changes go live for anyone not currently reading the article.

You can update an article from your CMS with an article you hand coded in a text editor.

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Click , then click Update Article.

4. Navigate to the article you hand coded.

5. Select the files as described in Upload an article.

Similarly, if you hand coded the original article, you can overwrite it by delivering that same article from your CMS.

You can edit the article title, excerpt, and thumbnail image that appear in feeds in the News app, and change the article’s canonical URL, as long as the article was delivered to News Publisher from your CMS or you hand coded and uploaded it.

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Click , then do any of the following:

   • Edit the article title: Enter a new title in the Title field. For best results, use a title between 80 and 110 characters.

   • Edit the article excerpt: Enter new text in the Excerpt field. For best results, use an excerpt between 130 and 305 characters.

   • Choose a different thumbnail image: Drag an image to the Thumbnail Image area, or click that area and browse for your image.

     Make sure the image meets the image specifications.

   • Edit the article’s canonical URL: Enter a URL.

     Your edits override the equivalent properties in the article.json file, but do not change the article.json file itself. The overrides remain in place when you make changes to the article.json file.

   When you finish editing, click Done.

You can click to revert your changes. When you revert a change to the article title, excerpt, thumbnail image, or canonical URL, you restore the “title” property from the Apple News Format ArticleDocument, and the “excerpt,” “thumbnailURL,” and “canonicalURL” properties from the Apple News Format Metadata, respectively.

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Click , then click “Sponsored article.”

If you want to discard your changes in News Publisher and restore the value set via the Apple News API or your CMS, click .

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Click , then click “Hide article from feeds.”

   The article won’t appear in feeds in the News app. Users can still access the article if they have a direct link.

If you want to discard your changes in News Publisher and restore the value set via the Apple News API or your CMS, click .

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Click , then do any of the following:

   • Change audience: Click the Audience menu, then choose Children, General, or Mature.

   • Change sections: Click the appropriate sections.

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Click , then click Download Article to download the article’s JSON bundle.

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Click Edit to the right of the article you want to edit, then make your changes in the article editor.

   Any changes you make are automatically saved.

4. Do one of the following:

   • Return to the list of articles: Click Articles in the toolbar.

   • Publish your changes: Click the Publish pop-up menu in the toolbar, choose the sections, audience, and advertising option for this article, then click Publish.

1. Go to icloud.com, sign in, then click News Publisher.

2. Click Articles, then click Draft Articles, All Published Articles, or a section.

3. Move the pointer over the title of the draft or published article you want to delete, then click .

   To delete multiple draft articles, click Draft Articles in the sidebar, then click Select Articles. Click the checkbox next to each article you want to delete, then click Delete Selected. To delete all draft articles, click the checkbox at the top of the list, then click Delete Selected.

When you delete a published article, it may take a few moments before it disappears from News.

When viewing a list of articles, enter a search term. You can search for the following:

• Article title

• Article text

• Article keywords

• Canonical URL—the article’s URL on your website