---
title: Developing the News page
---
> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).
Now we will create the News section of the tutorial website.
1. In the **Pages** application, select the root page (**My website**).
2. Click **New** ().
3. Choose the **Page (menu item)** page type.
4. Type _**News**_ as the **Page name** and select the **News -> News list** page template.
5. Click **Save**.
The News page uses a predefined template, so it is ready without any further modifications.
## Creating news articles
To add news articles to the website:
1. In the **Pages** application, select the **/News** page.
2. Click **New** ().
3. Choose the **News** page type.
4. Fill in the news page fields with the following values:
- **News Title**: News 1
- **Release Date**: click **Today**
- **News Summary**: News 1 summary.
- **News Text**: News 1 text.
- **Publish from/Publish to**: leave the fields blank
5. Click **Save and create another** and enter the following values:
- **News Title**: News 2
- **Release Date**: click **Today**
- **News Summary**: News 2 summary.
- **News Text**: News 2 text.
- **Publish from/Publish to**: leave the fields blank
6. Click **Save**.
If you select the /News page and switch to **Preview** mode, you can see a list of all news pages placed under the **News** section.
This is an example of how content is structured in Kentico. If you select a specific news item, the page displays the detail view.
The breadcrumbs at the top of the page show the current path on the website: **News > News 1**. The position is also reflected in the default page URLs:
- The URL of the News page is **\~/news.aspx**
- The URL of the News 1 page is **\~/news/news-1.aspx**
This makes the website accessible to both people and search engines.
## How does the News list work?
You may be wondering how Kentico generates the news list. The news page is a good example of using web parts to display structured page data on the website.
Select the **News** page, switch to **Edit** mode and open the **Design** tab. The page contains several web parts, including the **NewsRepeater**. This web part is based on the Repeater web part, which loads content from the database. Configure (double-click) the web part to view how the web part's properties are set.
The most important properties are the following:
| Property | Value | Description |
| ---------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Path | | Determines the path of the pages in the content tree from which the web part loads and displays data.
If you leave the value empty, the web part displays all pages under the current path (for pages) or displays the details of the selected page (for News pages).
See [Path expressions](#path-expressions) |
| Page types | cms.news | This property determines what types of pages the web part displays (news, products, blogs etc.). |
| Transformation | cms.news.preview | Assigns the transformation that the web part uses to display the list of news items. A transformation is a piece of code which converts raw database data of a page into user-friendly HTML output. |
| Selected item transformation | cms.news.default | When a user selects a specific news item on the website, the repeater displays the details according to the specified transformation. |
The following steps show how the page handles visitors:
1. A visitor arrives on the **/News** page.
2. The **Repeater** web part placed on the page template checks if a news page is currently selected (based on the value of the **Page types** property).
3. The web part finds out that the current page is a **Page (menu item)**, so it looks for all underlying news pages and displays them as a list using the **cms.news.preview** transformation.
4. When the visitor selects a particular news item, such as **/News/News 1**, the repeater web part uses the **cms.news.default** transformation instead to display the details.
## Path expressions
Listing web parts and controls have the **Path** property that specifies which content the component loads and displays. The following expressions are examples that you can use to select pages:
| Path expression | Meaning |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| /% | All pages on the website. |
| /news/% | All pages under /News. |
| /news/news1 | The News1 page. |
| ./% | All items under the current page. |
| ./logo | The Logo page under the current page. |
| ./images/% | All pages under the Images page, which is a child of the current page. |
| ../contacts/% | All pages under the Contacts page on the same content level as the current page. |
| /{0}/% | All pages under the page located on the first level of the current path.
Example:
If the currently selected page is:
_/news/news1_
the system evaluates the expression as:
_/news/%_ |