---
title: "Administration module"
manual: "News system"
version: "main"
permalink: "https://docs.typo3.org/permalink/georgringer/news:tsconfigadministration@main"
source: "Reference/TsConfig/Administration.rst"
rendered: "2026-09-23T19:24:09+00:00"
---

# Administration module {#tsconfigadministration}

Configuration of the **Web > News Administration** module

**Properties**

## preselect {#tsconfigpreselect}

-   **preselect**

    -   *Type:* array
    -   *Path:* tx_news > module

    Predefine the form in the administration module. The possible fields for
    the preselection are:

    -   recursive
    -   timeRestriction
    -   topNewsRestriction
    -   sortingField
    -   sortingDirection
    -   categoryConjunction

    ```typoscript
    # Example:
    tx_news.module {
       preselect {
          topNewsRestriction = 1
       }
    }
    ```

## columns {#tsconfigcolumns}

-   **columns**

    -   *Type:* string
    -   *Path:* tx_news > module
    -   *Default:* teaser,istopnews,datetime,categories

    Define a list of columns which are displayed in the administration module.
    Default is.

### Example: Show the columns datetime, archive and author {#example-show-the-columns-datetime-archive-and-author}

```typoscript
tx_news.module.columns = datetime,archive,author
```

## defaultPid {#tsconfigdefaultpid}

-   **defaultPid**

    -   *Type:* int
    -   *Path:* tx_news > module

    If no page is selected in the page tree, any record created in the
    administration module would be saved on the root page.
    If this is not desired, the pid can be defined by using defaultPid.\<tablename>:

### Example: Set default pid for new news records {#example-set-default-pid-for-new-news-records}

New news records will be saved on the page with ID 123.

```typoscript
# Example
tx_news.module.defaultPid.tx_news_domain_model_news = 123
```

## localizationView {#localizationview}

-   **localizationView**

    -   *Type:* bool
    -   *Path:* tx_news > module
    -   *Default:* 1

    Ability to disable the localizationView in the administration module. Example:

### Example: Disable the localization view {#example-disable-the-localization-view}

```typoscript
tx_news.module.localizationView = 0
```

## controlPanels {#controlpanels}

-   **controlPanels**

    -   *Type:* bool
    -   *Path:* tx_news > module
    -   *Default:* 0

    Display control panels to sort, hide and delete records in the administration
    module.

### Example: Enable the control panels {#example-enable-the-control-panels}

```typoscript
tx_news.module.controlPanels = 1
```

## allowedCategoryRootIds {#allowedcategoryrootids}

-   **allowedCategoryRootIds**

    -   *Type:* string, comma separated list of integers
    -   *Path:* tx_news > module

Reduce the shown categories by defining a list of **root** category IDs.

Example:

```none
Example category tree

├── [10] Cat 1
├── [12] Cat 2
├   └──[13] Cat 2 b
├── [14] Cat 3
└── [15] Cat 4
```

```typoscript
tx_news.module.allowedCategoryRootIds = 12,15
```

```none
Category tree shown

├── [12] Cat 2
├   └──[13] Cat 2 b
└── [15] Cat 4
```

## redirectToPageOnStart {#tsconfigredirecttopageonstart}

-   **redirectToPageOnStart**

    -   *Type:* integer
    -   *Path:* tx_news > module

If no page is selected, the user will be redirected to the given page.

### Example: redirect the user to page 456 {#example-redirect-the-user-to-page-456}

Redirect the user to the page with the uid 456, if no other page is chosen.

```typoscript
# Example:
tx_news.module.redirectToPageOnStart = 456
```

## allowedPage {#tsconfigallowedpage}

-   **allowedPage**

    -   *Type:* integer
    -   *Path:* tx_news > module

If defined, limit the administration module to the given page and always
redirect the user, no matter what defined in the page tree.

### Example: Limit the news module to page 123 {#example-limit-the-news-module-to-page-123}

Always redirect the user to the page with the uid 123.

```typoscript
# Example:
tx_news.module.allowedPage = 123
```

## alwaysShowFilter {#tsconfigalwaysshowfilter}

-   **alwaysShowFilter**

    -   *Type:* bool
    -   *Path:* tx_news > module

    If defined, the administration module will always show the filter opened.

### Example: Always show the filter {#example-always-show-the-filter}

```typoscript
# Example:
tx_news.module.alwaysShowFilter = 1
```

The user will be redirected to the page with the uid 123.

## filters {#filters}

-   **filters**

    -   *Type:* array
    -   *Path:* tx_news > module

    Define whether filters should be available or not. By default, all the
    filters are enabled. The available filters are:

    -   searchWord
    -   timeRestriction
    -   topNewsRestriction
    -   hidden
    -   archived
    -   sortingField
    -   number
    -   categories
    -   categoryConjunction
    -   includeSubCategories

    > [!NOTE]
    > `categoryConjunction` and `includeSubCategories` can only be enabled
    > when `categories` is enabled.

### Example: disable the filter of top news restriction {#example-disable-the-filter-of-top-news-restriction}

```typoscript
# Example:
tx_news.module {
   filters {
      topNewsRestriction = 0
   }
}
```