---
title: "Link.newRecord ViewHelper <be:link.newRecord>"
manual: "Fluid ViewHelper Reference"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3viewhelper:typo3-backend-link-newrecord@13.4"
source: "Backend/Link/NewRecord.rst"
modified: "2026-09-16T11:38:27+00:00"
---

# Link.newRecord ViewHelper `<be:link.newRecord>`

> [!NOTE]
> This ViewHelper is not available by default.
>
> [Import its namespace](https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/ApiOverview/Fluid/Index.html#fluid-syntax-viewhelpers-import-namespaces)
> `{namespace be=TYPO3\CMS\Backend\ViewHelpers\}` in the Fluid file or
> `xmlns:be="http://typo3.org/ns/TYPO3/CMS/Backend/ViewHelpers/"` in the opening HTML tag.

Use this ViewHelper to provide 'create new record' links.
The ViewHelper will pass the command to FormEngine.

The table argument is mandatory, it decides what record is to be created.

The pid argument will put the new record on this page, if `0` given it will
be placed to the root page.

The uid argument accepts only negative values. If this is given, the new
record will be placed (by sorting field) behind the record with the uid.
It will end up on the same pid as this given record, so the pid must not
be given explicitly by pid argument.

An exception will be thrown, if both uid and pid are given.
An exception will be thrown, if the uid argument is not a negative integer.

To edit records, use the [\<be:link.editRecordViewHelper>](https://docs.typo3.org/permalink/t3viewhelper:typo3-backend-link-editrecord@13.4).

Go to the source code of this ViewHelper: [Link\\NewRecordViewHelper.php (GitHub)](https://github.com/TYPO3/typo3/blob/main/typo3/sysext/backend/Classes/ViewHelpers/Link/NewRecordViewHelper.php).

## Arguments

> **Allows arbitrary arguments**
>
> This ViewHelper allows you to pass arbitrary arguments not defined below
> directly to the HTML tag created. This includes custom `data-` arguments.

-   **additionalAttributes**

    -   *Type:* array

    Additional tag attributes. They will be added directly to the resulting HTML tag.

-   **aria**

    -   *Type:* array

    Additional aria-\* attributes. They will each be added with a "aria-" prefix.

-   **data**

    -   *Type:* array

    Additional data-\* attributes. They will each be added with a "data-" prefix.

-   **defaultValues**

    -   *Type:* array
    -   *Default:* array (
    )

    default values for fields of the new record

-   **pid**

    -   *Type:* int

    the page id where the record will be created

-   **returnUrl**

    -   *Type:* string
    -   *Default:* ''

    return to this URL after closing the new record dialog

-   **table**

    -   *Type:* string
    -   *Required:* true

    target database table

-   **uid**

    -   *Type:* int

    uid < 0 will insert the record after the given uid