---
title: "Plugin"
manual: "News system"
version: "main"
permalink: "https://docs.typo3.org/permalink/georgringer/news:plugin@main"
source: "UsersManual/Plugins/Index.rst"
rendered: "2026-09-23T19:24:09+00:00"
---

# Plugin {#plugin}

The news plugin is used to output a defined list of records.

It can be added to create a content element with the type
**Plugin** and by selecting the plugin type **News system**.

**The available actions are:**

-   [List](https://docs.typo3.org/permalink/georgringer/news:list@main)
-   [News article detail view](https://docs.typo3.org/permalink/georgringer/news:news-article-detail-view@main)
-   [Date menu of news articles](https://docs.typo3.org/permalink/georgringer/news:date-menu-of-news-articles@main)
-   [News Search form](https://docs.typo3.org/permalink/georgringer/news:news-search-form@main)
-   [News Search result](https://docs.typo3.org/permalink/georgringer/news:news-search-result@main)
-   [News Category menu](https://docs.typo3.org/permalink/georgringer/news:news-category-menu@main)
-   [News Tag list](https://docs.typo3.org/permalink/georgringer/news:news-tag-list@main)

## List {#plugin-list}

The list action displays a list of defined records. The filters can be defined either in the plugin or by using TypoScript and are described [here](https://docs.typo3.org/permalink/georgringer/news:ts@main).

2 different list modes are available.

### News article list (incl. detail view) {#news-article-list-incl-detail-view}

CType: `news_pi1`

If a plugin is configured to show this implementation of the list action, it will change its behaviour if the URL contains a link to a detail action!
If this is fulfilled, the detail action will be shown instead of the list action.

### News article list {#news-article-list}

CType: `news_newsliststicky`

The described behaviour of the first implementation might not be desired all the time.
A typical example is to show a list view in the sidebar of a detail view page. If the above action would be used, the detail view would be shown in the sidebar too.

### News article list (curated) {#news-article-list-curated}

CType: `news_newsselectedlist`

Show a specific list of articles.

## News article detail view {#plugin-detail}

CType: `news_newsdetail`

There are 2 typical use cases for this action:

-   Use this action to show a full news record which is linked by a list view.
-   Provide a specific news record to output that one. This is very useful to embed a news record e.g. in a newsletter.

## Date menu of news articles {#plugin-datemenu}

CType: `news_newsdatemenu`

Use this action to show a list of news items grouped by the date. A typical output can look like:

```php
2015
   January: 13 entries
   February: 9 entries
   March: 6 entries
   June: 4 entries
   ...
2014
   March: 81 entries
   April: 32 entries
   May: 1 entry

```

If you define a specific page id in field **PageId for list display** (inside the tab **Additional**) and
placing a news plugin with the type **List** there, it is possible to create a date filter.

## News Search form {#plugin-searchform}

CType: `news_newssearchform`

Use this action to show a basic search inside news records.

## News Search result {#plugin-searchresult}

CType: `news_newssearchresult`

The search result action is based on the list action including an additional filter provided by the search form.

## News Category menu {#plugin-categorylist}

CType: `news_categorylist`

Use this action to show a list of categories. The categories are listed as tree.

If you define a specific page id in field **PageId for list display** (inside the tab "*Additional*") and
placing a news plugin with the type **List** there, it is possible to create a category filter.

> [!TIP]
> To have the selected category available, the checkbox "Disable override demand" must not be set in the category plugin.

## News Tag list {#plugin-taglist}

CType: `news_taglist`

Use this action to show a list of tags.

If you define a specific page id in field **PageId for list display** (inside the tab "*Additional*") and
placing a news plugin with the type **List** there, it is possible to create a tag filter.

> [!TIP]
> To keep the tags available after selecting one, the checkbox "Disable override demand" must be active in the tag plugin.