SharePoint Document Issues

Why SharePoint News Posts Have the Wrong Promoted State

Rana GarciaRana Garcia Nov 14, 2026 868 views

Question details

Determine why a newly published SharePoint news post has a Promoted State of 0 instead of 2.

Why SharePoint News Posts Have the Wrong Promoted State
Product
SharePoint
Device & OS
not provided
Scenario
A user publishes a news post from a template in a provisioned SharePoint site and checks its hidden Promoted State value.
Observed behavior
The published post has Promoted State 0, normally associated with a site page, rather than 2, which identifies a published news post.
Before you start

Identify the affected post's .aspx file name, the source template, and the site URL. You need permission to view items in the Site Pages library and their properties.

Solution 1Recommended

Compare the Promoted State of the post and its template

Use the Site Pages library data to distinguish the published post's value from the template's value.

Promoted State 0 normally identifies a site page, 1 identifies a news draft, and 2 identifies a published news post. A template and a post created from it are separate items, so their values should be checked separately.

Template behavior can vary between sites and may not be fully documented. A value of 1 is reported for a news draft template, but that does not establish why a published post remains at 0.

1
Confirm the post is published

Open the affected page from Site contents > Site Pages and check its publication status. If it is still a draft, use the page's Publish or Post news button.

2
Inspect the post's value

While signed in to the site, open this address in your browser, replacing <site-url> and the file name: <site-url>/_api/web/lists/getbytitle('Site Pages')/items?$select=FileLeafRef,PromotedState&$filter=FileLeafRef%20eq%20'YourPage.aspx'. Check PromotedState in the response.

3
Inspect the template

In Site contents > Site Pages, locate the source template in the Templates folder and note its .aspx file name. Repeat the REST request with that file name to compare its PromotedState with the post's value.

4
Retest in a new site

Provision a new site from the same site template, create a news post using the page template, and select Post news. Run the same REST request for the new post and compare the result.

Compare the Promoted State of the post and its template
Avoid changing the hidden value as a first step: The comparison helps isolate whether the behavior is specific to the template or site. Changing hidden metadata manually may not explain or resolve the underlying publishing behavior.
Free Microsoft Office alternative

Create Office documents with WPS Office

WPS Office is a free, lightweight alternative for creating and editing documents with a familiar interface. Its Office format support helps you move existing files into WPS, though it does not change SharePoint news metadata.

Draft and edit content for documents you plan to shareCompatible with Microsoft Office formats including DOCX, XLSX, and PPTXFamiliar editing tools make moving from Microsoft Office easierFree and lightweight office suite
microsoft office alternative - wps office

Frequently Asked Questions

What do the SharePoint Promoted State values mean?

Value 0 normally identifies a site page, 1 identifies a news draft, and 2 identifies a published news post. Check the post and its source template separately because they are different items.

Should a news template have Promoted State 1 or 2?

A news draft template is reported to use value 1; value 2 identifies a published news post. Template behavior can differ between sites, so inspect the template and test a post created from it rather than assuming they should have the same value.

How can I check the hidden Promoted State value?

Open the Site Pages REST endpoint in a signed-in browser session and select the FileLeafRef and PromotedState fields. Filter by the page's .aspx file name to identify the relevant item.

What if the published post still shows 0 in a new site?

Record the template and post values and the steps used to reproduce the issue. Use SharePoint Settings > Send feedback if available, or ask a Microsoft 365 administrator to create a support request.