Attention
TYPO3 v12 has reached end-of-life as of April 30th 2026 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 v12 here: TYPO3 ELTS.
The PageLinkHandler
The PageLinkHandler enables editors to link to pages and content.
It is implemented in class
\TYPO3\
of the system extension backend. The class is marked as
@internal and contains neither hooks nor events.
Changed in version 12.0
Due to the integration of EXT:recordlist into EXT:backend the namespace of
LinkHandlers has changed from
\TYPO3\
to
\TYPO3\.
For TYPO3 v12 the moved classes are available as an alias under the old
namespace to allow extensions to be compatible with TYPO3 v11 and v12.
The PageLinkHandler is preconfigured in the page TSconfig as:
TCEMAIN.linkHandler {
page {
handler = TYPO3\CMS\Backend\LinkHandler\PageLinkHandler
label = LLL:EXT:backend/Resources/Private/Language/locallang_browse_links.xlf:page
}
}
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.
Enable the field with the following page TSConfig:
TCEMAIN.linkHandler.page.configuration.pageIdSelector.enabled = 1