---
title: "Configuration with Site-Sets"
manual: "News system"
version: "main"
permalink: "https://docs.typo3.org/permalink/georgringer/news:configuration-site-set@main"
source: "Reference/SiteSets/Index.rst"
rendered: "2026-09-23T19:24:09+00:00"
---

# Configuration with Site-Sets {#configuration-site-set}

<!-- TODO: no Markdown rendering for "versionadded" -->

Use at least EXT:news 13.0.0 to get the full features of site sets.

The extension ships sets which can are used to configure various features.

> [!NOTE]
> **See also**
>
> Read more about Site Sets in the general documentation: [Site sets](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/SiteHandling/SiteSets.html#site-sets)!

1.  Got to backend module **Site Management > Sites**.
1.  Edit the configuration of your site.
1.  On the first tab go to **Sets for this Site**.
1.  Choose the sets you need. For the basic setup choose site set **EXT:news :: Basic Setup**.
1.  After saving, you can switch to the backend module **Site Management > Settings** to adopt the configurations.

    ![](../../Images/References/Sets/set-overview.png)
1.  Click on **Edit settings** to open the settings module. Each selected site set can provide its own settings.

    ![](../../Images/References/Sets/set-settings.png)
1.  All settings are persisted in `/config/sites/<your-site-identifier>/settings.yaml`.

## Available Site Sets {#available-site-sets}

> [!NOTE]
> Depending on your setup, it is possible that not all site sets are available!

-   [EXT:news :: Basic Setup](https://docs.typo3.org/permalink/georgringer/news:ext-news-basic-setup@main)
-   [EXT:news :: Twitter Bootstrap 5 Styles](https://docs.typo3.org/permalink/georgringer/news:ext-news-twitter-bootstrap-5-styles@main)
-   [EXT:news :: Twitter Bootstrap 4 Styles](https://docs.typo3.org/permalink/georgringer/news:ext-news-twitter-bootstrap-4-styles@main)
-   [EXT:news :: Record Links](https://docs.typo3.org/permalink/georgringer/news:ext-news-record-links@main)
-   [EXT:news :: Sitemap](https://docs.typo3.org/permalink/georgringer/news:ext-news-sitemap@main)

### EXT:news :: Basic Setup {#siteset-basic}

This is the basic site set. It is loaded **automatically** by all other site sets of this extension.

#### Available settings {#available-settings}

-   **news.view.templateRootPath**

    -   *Type:* string
    -   *Default:* EXT:news/Resources/Private/Templates/

    Path to the templates

-   **news.view.partialRootPath**

    -   *Type:* string
    -   *Default:* EXT:news/Resources/Private/Partials/

    Path to the partials

-   **news.view.layoutRootPath**

    -   *Type:* string
    -   *Default:* EXT:news/Resources/Private/Layouts/

    Path to the layouts

-   **news.pages.detail**

    -   *Type:* page
    -   *Default:* 0

    Page with detail view. This can be used as a site wide configuration for the detail view, used for all links to news records.

-   **news.preview.page**

    -   *Type:* page
    -   *Default:* 0

    Page with detail plugin used for previews.
    Allow editors to "save & view" a news record by providing the detail page

-   **news.preview.mode**

    -   *Type:* enum
    -   *Default:* news

    Either select "news" or "news_preview" as used argument name.
    The latter is required if preview should also work for hidden or restricted records.

    > [!NOTE]
    > **See also**
    >
    > Read more about the required additional configuration at [Allow preview of hidden records previewHiddenRecords](https://docs.typo3.org/permalink/georgringer/news:tspreviewhiddenrecords@main).

### EXT:news :: Twitter Bootstrap 5 Styles {#siteset-twb5}

Load the default template variants using Twitter Bootstrap v5 styles.

### EXT:news :: Twitter Bootstrap 4 Styles {#siteset-twb4}

Load the default template variants using Twitter Bootstrap v4 styles.

### EXT:news :: Record Links {#siteset-record-links}

Record links (or historically known as linkhandler) allow editors to link to
news records by selecting the record without needing to know on which page the
record will be rendered.

> [!WARNING]
> Never link to records by using an external url. Always use the record links!

More information can be found at [LinkHandler](https://docs.typo3.org/permalink/georgringer/news:linkhandler@main).

#### Available settings {#available-settings-1}

-   **news.recordLinks.label**

    -   *Type:* string
    -   *Required:* true
    -   *Default:* LLL:EXT:news/Resources/Private/Language/locallang_be.xlf:recordLinks.label

    The label used in the Link Browser. Use either a localizable string starting with LLL:EXT or directly a label

-   **news.recordLinks.storagePid**

    -   *Type:* page
    -   *Default:* 0

    The link browser starts with the given page. Ease the workflow by preselecting the news article storage page.

-   **news.recordLinks.hidePageTree**

    -   *Type:* bool
    -   *Default:* false

    Hide the page tree in the link browser. If only one storage page is used, the page tree can be hidden with this setting.

-   **news.recordLinks.detail**

    -   *Type:* page
    -   *Required:* true
    -   *Default:* 0

    Detail page. Select the page used for the detail view of the link.

### EXT:news :: Sitemap {#siteset-sitemap}

This site sets provides a configuration to generate a sitemap for news records.

> [!NOTE]
> This sitemap requires the core extension `seo` to be installed!

#### Available settings {#available-settings-2}

-   **news.sitemap.detail**

    -   *Type:* page
    -   *Required:* true
    -   *Default:* 0

    Select the page used to link the sitemap entries to.

-   **news.sitemap.startingpoint**

    -   *Type:* page
    -   *Required:* true
    -   *Default:* 0

    Select the page containing the news records (Starting point)

-   **news.sitemap.recursive**

    -   *Type:* int
    -   *Default:* 0

    Levels used to fetch pages containing the news records

-   **news.sitemap.additionalWhere**

    -   *Type:* string
    -   *Default:* 1

    Optional constraint to limit news records used in the sitemap