---
title: "Fields checked by the Linkvalidator"
manual: "Link Validator"
version: "14.3"
permalink: "https://docs.typo3.org/permalink/typo3/cms-linkvalidator:checked-fields@14.3"
source: "Configuration/Fields.rst"
rendered: "2026-09-22T20:17:07+00:00"
---

# Fields checked by the Linkvalidator {#checked-fields}

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

The following fields where added to the list of fields that are checked by
default:pages = canonical_linksys_redirect = targetsys_file_reference = link

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

Field pages.url has been removed in favour of the new pages.link field
as replacement and is used as default now.

The following tables and fields are supported by default:

-   `pages = link, canonical_link`
-   `sys_redirect = target`
-   `sys_file_reference = link`
-   `tt_content = bodytext, header_link`

Two special fields are currently defined, but are
not checked yet due to their TCA configuration:

-   `pages = media` has TCA `type="file"`
-   `tt_content = records` has TCA `type="group"`

The following fields could theoretically be included in
custom configurations, as their type / softref is available,
but they are specifically not added in the default configuration:

-   `sys_webhook = url` (webhook should not be invoked)
-   `tt_content = subheader` (has softref `email[subst]`
    which is not a supported link type)
-   `pages = tsconfig_includes` (system configuration)
-   `sys_template = constants, include_static_file, config`
    (system configuration)
-   `tx_scheduler_task_group = groupName` (scheduler
    system configuration)

## Required TCA configuration so a field can be checked by the Linkvalidator {#checked-fields-tca}

Currently, LinkValidator will only detect links for fields if the
TCA configuration meets one of these criteria:

-   at least one [softref](https://docs.typo3.org/m/typo3/reference-tca/main/en-us/ColumnsConfig/Type/Input/Index.html#tca_property_softref)
-   type is set to [link](https://docs.typo3.org/m/typo3/reference-tca/main/en-us/ColumnsConfig/Type/Link/Index.html#columns-link)

For this reason, it is currently not possible to check for
`pages.media`. This will be fixed in the future.

> [!NOTE]
> Detecting a soft reference is not the same as validating it: a match is
> only checked and reported as broken if it also resolves to one of the
> registered link types (`db` for internal links, `external` or `file`).
>
> Type [email](https://docs.typo3.org/m/typo3/reference-tca/main/en-us/ColumnsConfig/Type/Email/Index.html#columns-email) automatically adds the soft
> reference `email[subst]`, and the same soft reference can be added
> manually to other field types. It is currently parsed but does not
> resolve to any registered link type, so email addresses are neither
> validated nor reported as broken links - this is why
> `tt_content.subheader` is not part of the default configuration despite
> having a soft reference.

Examples for working fields:

-   `pages.canonical_link` (`'type' => 'link'`)
-   `pages.link` (`'type' => 'link'`)
-   `sys_file_reference.link` (`'type' => 'link'`)

Example for not working fields:

-   `pages.media` (`'type' => 'file'`)