Documentation · ViewHelper reference

XSD schema file | vhs 2.1.4

Render / RequestViewHelper

Render: Request

Renders a sub-request to the desired Extension, Plugin, Controller and action with the desired arguments.

Note: arguments must not be wrapped with the prefix used in GET/POST parameters but must be provided as if the arguments were sent directly to the Controller action.

  • Tag usage example

    <v:render.request action="[string|NULL]" controller="[string|NULL]" extensionName="[string|NULL]" pluginName="[string|NULL]" vendorName="[string|NULL]" arguments="{foo: 'bar'}" pageUid="123" onError="NULL" graceful="1">
    	<!-- tag content - may be ignored! -->
  • Inline usage example

    {v:render.request(action: [string|NULL], controller: [string|NULL], extensionName: [string|NULL], pluginName: [string|NULL], vendorName: [string|NULL], arguments: {foo: 'bar'}, pageUid: 123, onError: 'NULL', graceful: 1)}


Argument Description Type
action string|NULL
arguments array
controller string|NULL
extensionName string|NULL

If forced to FALSE, errors are not caught but rather "transmitted" as every other error would be


Optional error message to display if error occur while rendering. If NULL, lets the error Exception pass trough (and break rendering)

pageUid integer
pluginName string|NULL
vendorName string|NULL
Required attribute

Revision history

commit ca3e6eecbf0b59bc75e9a6daab2a97083085ed18
Author: Claus Due <*****>
Date:   Sun Nov 11 02:18:08 2012 +0100

    [FEATURE] Render / Request ViewHelper
    Renders a sub-request, works much like an ESI/SSI including a
    pre-rendered Request. Works well when surrounded with the Render /
    Cache ViewHelper, whenever appropriate. Caching is not built into

commit e384b12bb4fc4fa18f2334f6b3e7babaf7681a92
Author: Claus Due <*****>
Date:   Sat Jan 26 15:40:13 2013 +0100

    [DOC] Doc comment for Render / Request ViewHelper

commit 62ddda8f3b6342e1d3f0db8383e44bb27f9c2401
Author: Matthias Gugel <*****>
Date:   Mon Jul 8 01:33:52 2013 +0200

    [BUGFIX] Tx_Extbase_Object_ObjectManagerInterface::create() is deprecated
    Fixed by calling Tx_Extbase_Object_ObjectManagerInterface::get() instead.

commit 88f5caae94aaf488b5c87df0899a14aad3aaef13
Author: Peter Jaraczewski <*****>
Date:   Tue Jul 23 10:33:44 2013 +0200

    [BUGFIX] Missing vendorName property in <v:render.request /> ViewHelper

commit e3f0ba26edf91b63fef25776cc22282f022c9547
Author: Peter Jaraczewski <*****>
Date:   Tue Jul 23 11:39:57 2013 +0200

    [TASK] Setting vendorName to optional to provide fallback for non namespaced extensions

commit e0be826cbf19cc69e537cc54921f75d1d188c040
Author: Cedric Ziel <*****>
Date:   Tue Jul 23 12:08:24 2013 +0200

    [TASK] Fix Backwards compatibility in v:render.request

commit da31bad1d9bb058c072ddb5591e8ed907a1ae8e1
Author: Claus Due <*****>
Date:   Tue Dec 31 23:08:37 2013 +0100

    [TASK] Happy new year!

commit d2e531da034976e6db1478eef5a8478595fd16fe
Author: Claus Due <*****>
Date:   Sun Jan 5 00:45:10 2014 +0100

    [TASK] Migrate to using namespace core class names

commit 52bd6e41ccfef3d8193b350153912a9716e6a087
Author: Benjamin Rau <*****>
Date:   Tue Apr 1 21:09:00 2014 +0200

    [TASK] CGL compliance

commit da7677bc74f14e9a9300e4ba4487e52c3cb97642
Author: Claus Due <*****>
Date:   Sun Apr 20 01:13:33 2014 +0200

    [TASK] Switch to namespaces

commit 12ff0ddfb8d36c51f2d3befde7ae812177c80d5d
Author: Xaver Maierhofer <*****>
Date:   Wed Jun 11 00:01:47 2014 +0200

    [TASK] CGL remove use leading backslash
    PHP Docs
    Note that for namespaced names (fully qualified namespace names containing namespace separator, such as Foo\Bar as opposed to global names that do not, such as FooBar),
    the leading backslash is unnecessary and not recommended, as import names must be fully qualified, and are not processed relative to the current namespace.

commit 4981055359c895f3869e5bd878293b3c15ed26e5
Author: Xaver Maierhofer <*****>
Date:   Sun Jan 18 14:01:04 2015 +0100

    [TASK] CGL - Define classes, params, use imports

commit 8bb2fc5ee124ba19b0a0ab8e061c9a153fc4651f
Author: Xaver Maierhofer <*****>
Date:   Sun Jan 18 17:56:13 2015 +0100

    [TASK] Reference Copyright to file