# SharePoint List News app

Show items from a **custom SharePoint list** as a news carousel. Use this when your announcements don't live in the built-in News web part but in a list you've built yourself.

## Creating a SharePoint List News app

1. Go to **Content > New > App** and search for the **SharePoint List 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.
5. Pick the **Site** and then the **List** inside that site.
6. Tell the app which list columns to use:
   - **Title field** — defaults to `Title`.
   - **Content field** — defaults to `Body`.
7. Tweak rotation and styling.
8. Click **Create app**.

::: tip Column names are case-sensitive
SharePoint's internal column name may differ from the display name you see in the UI. If posts look empty, check the list's column settings and use the internal name (often shown with `spaces_replaced_with_x0020_`).
:::

## 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** |
| List | List within the site | **Yes** |
| Title field | Column used as the post title (default `Title`) | **Yes** |
| Content field | Column used as the post body (default `Body`) | **Yes** |
| Seconds per item | How long each item is shown (default 20) | **Yes** |
| Items to show | How many items rotate (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 |