---
title: "The PageLinkHandler"
manual: "TYPO3 Explained"
version: "11.5"
permalink: "https://docs.typo3.org/permalink/t3coreapi:pagelinkhandler@11.5"
source: "ApiOverview/LinkHandling/Linkhandler/PageLinkHandler.rst"
rendered: "2026-10-21T15:30:00+00:00"
---

> [!WARNING]
> **Attention**
>
> TYPO3 v11 has reached end-of-life as of October 31th 2024 and
> is no longer being maintained. Use the version switcher on the top
> left of this page to select documentation for a supported version of TYPO3.
>
> Need more time before upgrading?
> You can purchase Extended Long Term Support (ELTS) for TYPO3 v11 here:
> [TYPO3 ELTS](https://typo3.com/services/extended-support-elts).

# The PageLinkHandler {#pagelinkhandler}

The PageLinkHandler enables editors to link to pages and content.

It is implemented in class `\TYPO3\CMS\Recordlist\LinkHandler\PageLinkHandler`
of the system extension `recordlist`. The class is marked as
`@internal` and contains neither hooks nor events.

The PageLinkHandler is preconfigured in the page TSconfig as:

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

```typoscript
TCEMAIN.linkHandler {
   page {
      handler = TYPO3\\CMS\\Recordlist\\LinkHandler\\PageLinkHandler
      label = LLL:EXT:recordlist/Resources/Private/Language/locallang_browse_links.xlf:page
   }
}
```

## Enable direct input of the page id {#enable-direct-input-of-the-page-id}

It is possible to enable an additional field in the link browser to enter the uid of a page.
The uid will be used directly instead of selecting it from the page tree.

![The link browser field for entering a page uid.](Images/LinkBrowserTSConfigExamplepageIdSelector.png)

Enable the field with the following page TSConfig:

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

```typoscript
TCEMAIN.linkHandler.page.configuration.pageIdSelector.enabled = 1
```