Attention

TYPO3 v10 has reached end-of-life as of April 30th 2023 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 v10 here: TYPO3 ELTS.

uri.newRecord

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:uri.editRecord>.

Examples

Uri to create a new record of a_table after record 17 on the same pid:

<be:uri.newRecord table="a_table" returnUrl="foo/bar" uid="-17"/>

/typo3/index.php?route=/record/edit&edit[a_table][-17]=new&returnUrl=foo/bar

Uri to create a new record of a_table on root page:

<be:uri.newRecord table="a_table" returnUrl="foo/bar""/>

/typo3/index.php?route=/record/edit&edit[a_table][]=new&returnUrl=foo/bar

Uri to create a new record of a_table on page 17:

<be:uri.newRecord table="a_table" returnUrl="foo/bar" pid="17"/>

/typo3/index.php?route=/record/edit&edit[a_table][-17]=new&returnUrl=foo/bar

Arguments

uid

DataType

mixed

Required

false

Description

Uid < 0 will insert the record after the given uid

pid

DataType

mixed

Required

false

Description

The page id where the record will be created

table

DataType

string

Required

true

Description

Target database table

returnUrl

DataType

string

Required

false

Description

Return to this URL after closing the edit dialog