Link handler configuration¶
Link browser tabs are registered in page TSconfig like this:
TCEMAIN.linkHandler {
haiku {
handler = TYPO3\CMS\Recordlist\LinkHandler\RecordLinkHandler
label = LLL:EXT:examples/Resources/Private/Language/locallang_browse_links.xlf:haiku
configuration {
table = tx_examples_haiku
}
displayAfter = url
scanBefore = page
}
}
See the complete example: Tutorial: Custom record link browser.
Changed in version 12.0: Due to the integration of EXT:recordlist into EXT:backend the namespace of
link handlers has changed from
TYPO3\CMS\Recordlist\LinkHandler
to
TYPO3\CMS\Backend\LinkHandler
.
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.
Possible options are:
handler
The fully-qualified classname of the link handler.
label
The name displayed on the tab button in the link browser.
displayAfter
/displayBefore
Can be used to decide the order of the tabs.
scanAfter
/scanBefore
The first backend link handler who determines that it can handle the link may edit a link. Most likely your links will start with a specific prefix to identify them.
You should register your tab at least before the
url
link handler. Theurl
link handler treats all links, that no other handler can treat.configuration
Some custom configuration, available to the backend link handler.
Record link handler configuration¶
Record link handlers have the following additional options:
configuration.hidePageTree = 1
Hide the page tree in the link browser
configuration.storagePid = 84
The link browser starts with the given page
configuration.pageTreeMountPoints = 123,456
Only records on these pages and their children will be displayed
Page link handler configuration¶
configuration.pageIdSelector.enabled
Enable an additional field in the link browser to enter the uid of a page.

Enable the field with the following page TSConfig:
TCEMAIN.linkHandler.page.configuration.pageIdSelector.enabled = 1