---
title: "The PageLinkHandler"
manual: "TYPO3 Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3coreapi:pagelinkhandler@main"
source: "ApiOverview/LinkHandling/Linkhandler/PageLinkHandler.rst"
rendered: "2026-09-28T04:36:23+00:00"
---

# The `PageLinkHandler` {#pagelinkhandler}

The PageLinkHandler enables editors to link to pages and content.

It is implemented in class `\TYPO3\CMS\Backend\LinkHandler\PageLinkHandler`
of the system extension `backend`. 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\Backend\LinkHandler\PageLinkHandler
    label = backend.browse_links:page
  }
}

```

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

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
```