TYPO3 Logo
Fluid ViewHelper Reference
Options
Give feedback View source How to edit Edit on GitHub Full documentation (single file)

Fluid ViewHelper Reference

  • Global (f:*)
    • Asset
      • asset.css
      • asset.module
      • asset.script
    • Be
      • Menus
        • be.menus.actionMenu
        • be.menus.actionMenuItem
        • be.menus.actionMenuItemGroup
      • Security
        • be.security.ifAuthenticated
        • be.security.ifHasRole
      • be.infobox
      • be.link
      • be.pageInfo
      • be.pagePath
      • be.pageRenderer
      • Be.tableList ViewHelper <f:be.tableList>
      • be.uri
    • Cache
      • cache.disable
      • cache.static
      • cache.warmup
    • Debug
      • debug.render
    • form
      • form.button
      • form.checkbox
      • form.countrySelect
      • form.hidden
      • form.password
      • form.radio
      • form.select
      • form.submit
      • form.textarea
      • form.textfield
      • form.upload
      • form.uploadDeleteCheckbox
      • form.validationResults
    • Format
      • format.bytes
      • format.case
      • format.cdata
      • format.crop
      • format.currency
      • format.date
      • format.html
      • format.htmlentities
      • format.htmlentitiesDecode
      • format.htmlspecialchars
      • format.json
      • format.nl2br
      • format.number
      • format.padding
      • format.printf
      • format.raw
      • format.stripTags
      • format.trim
      • format.urlencode
    • Link
      • link.action
      • link.email
      • link.external
      • link.file
      • link.page
      • link.typolink
    • Sanitize
      • sanitize.html
    • Security
      • security.ifAuthenticated
      • security.ifHasRole
      • security.nonce
    • Transform
      • transform.html
    • Uri
      • uri.action
      • uri.external
      • uri.image
      • uri.page
      • uri.resource
      • uri.typolink
    • alias
    • argument
    • case
    • cObject
    • comment
    • constant
    • count
    • cycle
    • debug
    • defaultCase
    • else
    • feature
    • first
    • flashMessages
    • for
    • groupedFor
    • if
    • image
    • inline
    • join
    • last
    • layout
    • media
    • or
    • render
    • replace
    • section
    • spaceless
    • split
    • switch
    • then
    • translate
    • variable
  • Backend (be:*)
    • Link
      • link.documentation
      • link.editRecord
      • link.newRecord
    • Mfa
      • mfa.ifHasState
    • Toolbar
      • toolbar.attributes
      • toolbar.ifHasDropdown
    • TypoScript
      • typoScript.fineDiff
    • Uri
      • uri.editRecord
      • uri.newRecord
    • avatar
    • languageColumn
    • loginLogo
    • moduleLink
    • thumbnail
  • Core (core:*)
    • icon
    • iconForRecord
    • iconForResource
    • normalizedUrl
  • Form (formvh:*)
    • Be
      • be.maximumFileSize
      • be.renderContentElementPreview
    • Form
      • form.datePicker
      • form.timePicker
      • form.uploadedResource
    • form
    • gridColumnClassAutoConfiguration
    • render
    • renderAllFormValues
    • renderFormValue
    • renderRenderable
    • translateElementError
    • translateElementProperty
  • Contribution
  • Sitemap
  1. Fluid ViewHelper Reference
  2. Backend (be:*)
  3. Link
  4. link.newRecord
Give feedback Edit on GitHub

Link.newRecord ViewHelper <be:link.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:link.editRecordViewHelper>.

Examples

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

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

Output:

<a href="/typo3/record/edit?edit[a_table][-17]=new&returnUrl=foo/bar">
    New record
</a>
Copied!

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

<be:link.newRecord table="a_table" returnUrl="foo/bar""/>
Copied!

Output:

<a href="/typo3/record/edit?edit[a_table][]=new&returnUrl=foo/bar">
    New record
</a>
Copied!

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

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

Output:

<a href="/typo3/record/edit?edit[a_table][17]=new&returnUrl=foo/bar">
    New record
</a>
Copied!

Link to create a new record then return back to the BE module "web_MyextensionList":

<be:link.newRecord table="a_table" returnUrl="{f:be.uri(route: 'web_MyextensionList')}" pid="17">
Copied!

Output:

<a href="/typo3/record/edit?edit[a_table][17]=new&returnUrl=/typo3/module/web/MyextensionList">
    New record
</a>
Copied!

Link to create a new record of a_table on page 17 with a default value:

<be:link.newRecord table="a_table" returnUrl="foo/bar" pid="17" defaultValues="{a_table: {a_field: 'value'}}">
Copied!

Output:

<a href="/typo3/record/edit?edit[a_table][17]=new&returnUrl=foo/bar&defVals[a_table][a_field]=value">
    New record
</a>
Copied!

Go to the source code of this ViewHelper: Link\NewRecordViewHelper.php (GitHub).

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.

The following arguments are available for the link.newRecord ViewHelper:

additionalAttributes

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

aria

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

data

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

defaultValues

defaultValues
Type
array
Default
array ( )
default values for fields of the new record

pid

pid
Type
int
the page id where the record will be created

returnUrl

returnUrl
Type
string
Default
''
return to this URL after closing the new record dialog

table

table
Type
string
Required
1
target database table

uid

uid
Type
int
uid < 0 will insert the record after the given uid
  • Previous
  • Next
Reference to the headline

Copy and freely share the link

This link target has no permanent anchor assigned. You can make a pull request on GitHub to suggest an anchor. The link below can be used, but is prone to change if the page gets moved.

Copy this link into your TYPO3 manual.

  • Home
  • Contact
  • Issues
  • Repository

Last rendered: May 23, 2025 01:30

© since 2018 by the TYPO3 contributors
  • Legal Notice
  • Privacy Policy