---
title: "LinkHandler"
manual: "News system"
version: "main"
permalink: "https://docs.typo3.org/permalink/georgringer/news:linkhandler@main"
source: "Tutorials/BestPractice/Linkhandler/Index.rst"
rendered: "2026-09-23T19:24:09+00:00"
---

# LinkHandler {#linkhandler}

**LinkHandler** is the synonym for making it possible for editors to create links to custom records.
Until 8 LTS a 3rd party extension has been required but since then it is integrated into the Core. Read at [https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/8.6/Feature-79626-IntegrateRecordLinkHandler.html](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/8.6/Feature-79626-IntegrateRecordLinkHandler.html) about the feature.

> [!TIP]
> This tutorial is also valid for creating links to any other record.

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

A site is provided to configure record links on one place. See EXT:news :: Record Links.

## Configuration for the backend {#configuration-for-the-backend}

PageTsConfig is used to configure the link browser in the backend.

Also have a look at TYPO3 documentation about the `RecordLinkHandler` at [https://docs.typo3.org/m/typo3/reference-coreapi/12.4/en-us/ApiOverview/LinkHandling/Linkhandler/RecordLinkHandler.html#recordlinkhandler](https://docs.typo3.org/m/typo3/reference-coreapi/12.4/en-us/ApiOverview/LinkHandling/Linkhandler/RecordLinkHandler.html#recordlinkhandler)

**EXT:my_sitepackage/Configuration/page.tsconfig**

```typoscript
# tx_news is an identifier, don't change it after links have been created
TCEMAIN.linkHandler.tx_news {
   handler = TYPO3\CMS\Backend\LinkHandler\RecordLinkHandler
   # A translatable label can be used with LLL:EXT:theme/locallang.xml:label
   label = News
   configuration {
      table = tx_news_domain_model_news
      # Default storage pid
      storagePid = 123
      # Hide the page tree by setting it to 1
      hidePageTree = 0
   }
   scanAfter = page
}
```

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

If the identifier starts with tx_news, the URLs of articles of the type "Internal" and "External" are correctly retrieved.

## Configuration for the frontend {#configuration-for-the-frontend}

The links are now stored in the database with the syntax `<a href="t3://record?identifier=tx_news&amp;uid=456">A link</a>`.
By using TypoScript, the link is transformed into an actual link.

**EXT:my_sitepackage/Configuration/TypoScript/setup.typoscript**

```typoscript
config.recordLinks.tx_news {
   typolink {
      # Detail page
      parameter = 123
      additionalParams.data = field:uid
      additionalParams.wrap = &tx_news_pi1[controller]=News&tx_news_pi1[action]=detail&tx_news_pi1[news]=|
   }
}
```

### Dynamic target page from category field single_pid {#dynamic-target-page-from-category-field-single-pid}

If the detail page is provided by the category, the following code can be used to retrieve the target page:

**EXT:my_sitepackage/Configuration/TypoScript/setup.typoscript**

```typoscript
config.recordLinks.tx_news {
    typolink {
        # Detail page
        parameter.cObject = USER
        parameter.cObject {
            userFunc = GeorgRinger\News\Service\LinkHandlerTargetPageService->process
            news.data = field:uid
            # Page used if no detail page is set in the category
            fallback = 123
        }
        additionalParams.data = field:uid
        additionalParams.wrap = &tx_news_pi1[controller]=News&tx_news_pi1[action]=detail&tx_news_pi1[news]=|
    }
}
```