# SharePoint News app

Show news items from a SharePoint site's built-in **News** web part as an auto-rotating carousel.

## Creating a SharePoint News app

1. Go to **Content > New > App** and search for the **SharePoint News** app.
2. Click the app to start creating a new app.
3. Enter an **app name**.
4. Click **Connect account** and sign in with a Microsoft account that can read the SharePoint site. This creates a Microsoft [connection](/features/connections) in your workspace (reusable for other SharePoint and Teams apps).
5. Pick the **Site** — only sites the connected account can read are available.
6. Tweak rotation speed, item count, and styling.
7. Click **Create app**.

::: warning Use SharePoint List News for custom lists
This app only reads the built-in SharePoint News web part. If your news lives in a **custom list** instead, use the [SharePoint List News](/features/apps/sharepoint-list-news) app and map the columns.
:::

::: tip Aggregate news across an entire hub
This app reads a **single site**. To roll up news from a whole **hub** — the hub site plus every site associated with it — set SharePoint News up as a **data source** instead and enable *Include news from the entire hub*. See [Connect Microsoft SharePoint](/how-to/connect-sharepoint).
:::

::: tip Full content vs. number of items
The datasource can either fetch each post's full article body or just its short summary, and this affects how many items we load:

- **With full content on**, we fetch each article's body individually, so to stay efficient we load the **20 most recent** news items.
- **With full content off** (summary only), no per-article fetch is needed, so we load the **100 most recent** news items.
:::

## All configuration options

| Setting | Explanation | Required |
|---|---|---|
| App name | A recognizable name shown in your content library | **Yes** |
| Account | Microsoft (OAuth) connection | **Yes** |
| Site | SharePoint site URL | **Yes** |
| Seconds per item | How long each news item is shown (default 20) | **Yes** |
| Items to show | How many news items to rotate through (default 10) | No |
| Filter recency | Only include items newer than N days | No |
| Recency days | Days cutoff when recency filter is on | Conditional |
| Font / colors / header / logo toggles | Up to 9 styling fields | No |