Documentation · ViewHelper reference


View helper which renders the flash messages (if there are any) as an unsorted list.
In case you need custom Flash Message HTML output, please write your own ViewHelper for the moment.



<f:flashMessages />


An ul-list of flash messages.

Output with custom css class

<f:flashMessages class="specialClass" />



TYPO3 core style

<f:flashMessages />


  • Some Message Header

    Some message body

  • Some notice message without header

Output flash messages as a description list

<f:flashMessages as="flashMessages">
<f:for each="{flashMessages}" as="flashMessage">


Some Warning Message.

Using a specific queue

<f:flashMessages queueIdentifier="myQueue" />
  • Tag usage example

    <f:flashMessages additionalAttributes="{foo: 'bar'}" data="{foo: 'bar'}" renderMode="NULL" as="NULL" class="NULL" dir="NULL" id="NULL" lang="NULL" style="NULL" title="NULL" accesskey="NULL" tabindex="123" onclick="NULL" queueIdentifier="NULL">
    	<!-- tag content - may be ignored! -->
  • Inline usage example

    {f:flashMessages(additionalAttributes: {foo: 'bar'}, data: {foo: 'bar'}, renderMode: 'NULL', as: 'NULL', class: 'NULL', dir: 'NULL', id: 'NULL', lang: 'NULL', style: 'NULL', title: 'NULL', accesskey: 'NULL', tabindex: 123, onclick: 'NULL', queueIdentifier: 'NULL')}


Argument Description Type

Keyboard shortcut to access this element


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


The name of the current flashMessage variable for rendering inside


CSS class(es) for this element


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


Text direction for this HTML element. Allowed strings: "ltr" (left to right), "rtl" (right to left)


Unique (in this file) identifier for this HTML element.


Language for this element. Use short names specified in RFC 1766


JavaScript evaluated for the onclick event


Flash-message queue to use


@deprecated since TYPO3 CMS 7.3. If you need custom output, use ...


Individual CSS styles for this element


Specifies the tab order of this element


Tooltip text of element

Required attribute

Revision history

commit aa1fb6f5adb8a799e79dbe54192d49b336a26786
Author: Sebastian Kurfürst <*****>
Date:   Tue Mar 16 08:49:45 2010 +0000

    [!!!][TASK] Fluid: Raised version number to 1.1.0. This  version needs Extbase 1.1.0 as well!
    [TASK] Fluid: Backported all changes from Fluid v5 again. This includes mostly some internal restructurings.
    [!!!][TASK] Fluid (ViewHelpers): The <f:base> ViewHelper now creates a self-closing tag instead of an opening/closing tag. This is standards-conformant, but will BREAK IE6!!

commit 186bdaeac89820779f91853b830cc95d60c7ad58
Author: Bastian Waidelich <*****>
Date:   Tue Jul 13 09:42:26 2010 +0000

    [-TASK] Fluid: R*****@version annotation from all Fluid classes to ease the backporting process. Relates to #8835 (backported from Fluid package)

commit 1d36de6ed90007e324b773782e8f0a1d1c1191a2
Author: Bastian Waidelich <*****>
Date:   Tue Jul 13 10:12:30 2010 +0000

    [-TASK] Fluid: R*****@package/@subpackage annotations from all Fluid classes. They have already been removed in FLOW3 packages in r2813.

commit 2bd9f56a7a820e303cc9ad9900557edb677136a8
Author: Bastian Waidelich <*****>
Date:   Tue Jul 13 14:17:07 2010 +0000

    [+BUGFIX] Fluid: Replaced SplObjectStorage by Tx_Extbase_Persistence_ObjectStorage to be PHP 5.2-compatible (which ships with a broken implementation of SplObjectStorage)
    [!!!][~TASK] Fluid (Core): Renamed ConditionViewHelper and TagBasedViewHelper to Abstract*ViewHelper as per CGL. (backported from Fluid package r4840). To be backwards-compatible, TagBasedViewHelper.php still exists and will write an entry to TYPO3s deprecation log if used. Please adapt your custom ViewHelpers and inherit from AbstractTagBasedViewHelper instead of TagBasedViewHelper. This resolves #8834
    [~TASK] Fluid: Marked vfs unit tests to be skipped, as vfs is not part of v4 (yet)

commit ef7d3554317f302e9c5b23c107572a0f842cc071
Author: Bastian Waidelich <*****>
Date:   Thu Jul 22 14:49:56 2010 +0000

    [~TASK] Fluid (ViewHelpers): Fresh backport from Fluid package r4899 (Mostly fixed typos. slightly improved count ViewHelper)

commit 472451987ca0530fa5828bb0b79fcafa2f905a35
Author: Bastian Waidelich <*****>
Date:   Fri Nov 19 20:58:09 2010 +0000

    [-TASK] Fluid: R*****@scope annotations as they are not used in v4

commit ceb3880c072215293ddc94125df5ee69ac288e2d
Author: Bastian Waidelich <*****>
Date:   Sat Nov 27 11:36:24 2010 +0000

    [+FEATURE] Fluid (ViewHelpers): Add render mode to FlashMessage ViewHelper
    Since r3062 Extbase uses the t3lib_FlashMessageQueue to store flashmessages.
    Now you can output them including title and severity, making it possible
    to render flashmessages just like the ones from the core in BE mode.
    To keep backwards compatibility, the default rendering still outputs
    only the message bodies in an unordered list. Set the renderMode argument
    to "div" in order to display the new style:
    <f:flashMessages renderMode="div" />
    Relates to: #10821

commit dd8928aed4c119d8db37322acb91ded24ba5cc35
Author: Bastian Waidelich <*****>
Date:   Thu Dec 30 16:21:11 2010 +0000

    [+TASK] Fluid (ViewHelpers): Fix, cleanup and extend inline documentation of ViewHelpers
    Resolves #10908

commit 02fef6a059388dc62ac95c8c129f13291cc3e0b6
Author: Bastian Waidelich <*****>
Date:   Tue Jan 25 16:29:52 2011 +0000

    [+TASK] Fluid (ViewHelpers): Extended inline documentation of FlashMessages ViewHelper

commit b3637985e7ebb34dd12d6181b214ae5ce4b70f54
Author: Bastian Waidelich <*****>
Date:   Thu Jul 28 17:01:44 2011 +0200

    [!!!][FEATURE] Compilation of Fluid templates to PHP files
    This adds a compile step to the parsing process of templates, layouts and
    If no compiled cache file exists, Fluid will create it while parsing the
    respective Fluid template.
    The cache file is invalidated as soon as the template/layout/partial
    has been modified (or if caches are flushed).
    This speeds up the rendering process by factor 2-5!
    Breaking change:
    * AbstractViewHelper::$arguments are no longer an object but an array.
      If you used $this->arguments->hasArgument() in your custom ViewHelpers,
      you'll have to replace this with $this->hasArgument()
    Change-Id: Idb71f85ea7223755df4bc1c0ff9f8807f1924323
    Related: #28544
    Resolves: #28545

commit bcc1fceeafbf0cc3233bc7db8c87a0018ef6b452
Author: Claus Due <*****>
Date:   Mon May 16 23:23:31 2011 +0200

    [+BUGFIX] disable cache when displaying FlashMessages in frontend
    This resolves #5297 by making the FlashMessage
    ViewHelper disable the page cache to prevent caching rendered
    FlashMessage-HTML in a cacheable controller action which uses
    Change-Id: I2eeb615625442d9040a0bb21b9e231e224dcba86
    Fixes: #5297

commit fd09d197fa8886b97cb20aa9573f39cd08ce989e
Author: Bastian Waidelich <*****>
Date:   Thu Nov 10 18:27:58 2011 +0100

    [TASK] S*****@author annotations
    This backports three recent changes of the TYPO3.Fluid package:
    - R*****@license annotation from files (290f4f5)
    - Simplify license header in PHP files (14bacba)
    - D*****@author tags from source code (9c2e837)
    This should not contain any functional change!
    Change-Id: I9376dca4af78c4f0f82413011d115b8ad04634dd

commit ca40f8a066da4ea3c849d74f68a9bc73758976c5
Author: dkd-egerer Sascha Egerer <*****>
Date:   Sat Apr 14 21:43:10 2012 +0200

    [TASK] Remove trailing whitespace
    There must be no empty lines after the closing
    PHP tag. Empty lines after closing tags break
    output compression in PHP and/or result in AJAX
    Change-Id: I0484ca29d8134d0828cf30880d5aafd43ed9d78e
    Resolves: #36076
    Releases: 6.0
    Reviewed-by: Ingo Pfennigstorf
    Tested-by: Ingo Pfennigstorf
    Reviewed-by: Daniel Lorenz
    Tested-by: Daniel Lorenz
    Reviewed-by: Christian Kuhn
    Tested-by: Christian Kuhn

commit ec3891d8d4e339d8319428211207e6201be9fd73
Author: Thomas Maroschik <*****>
Date:   Wed Oct 17 21:18:26 2012 +0200

    [TASK][WIP] Move non class code back to source files
    Change-Id: I620d2e61860142cdc89cc83474c95542799961c0

commit 554e8f890dcc0dd86a27518b58e2b54be26fd37e
Author: Thomas Maroschik <*****>
Date:   Wed Oct 17 22:20:17 2012 +0200

    [TASK] Namespace classes
    Change-Id: Ia7432e1c923826ed58206bca15fb94509adbd508

commit 547ef7f60f39c6bfcb0376e5e76070da85860098
Author: Arvid Jakobsson <*****>
Date:   Mon Sep 17 21:25:51 2012 +0200

    [TASK] Remove superfluous parenthesis in sysexts
    Superfluous brackets in fluid after namespaces move
    Change ("a" . "b") . "c" into "a" . "b" . "c" using the lex-pass tool.
    Resolves: #41016
    Related: #40095
    Releases: 6.0
    Change-Id: I64741473cb24eda343f0576ebd1a0f1846dfc3f8
    Reviewed-by: Oliver Hader
    Tested-by: Oliver Hader

commit 9d13dedf017b614b834261b1bf5d4acb2201f1d4
Author: Alexander Schnitzler <*****>
Date:   Fri Nov 16 19:49:02 2012 +0100

    [CLEANUP] Replace FLOW3 with TYPO3 Flow
    Releases: 6.0
    Fixes: #43036
    Change-Id: I62df23587301b4cde3ddeae3686b34f54fe1182e
    Reviewed-by: Alexander Schnitzler
    Tested-by: Alexander Schnitzler

commit 9d46e6932d35c79bf87c96fa38b8e537c4192f23
Author: Alexander Schnitzler <*****>
Date:   Tue Nov 20 16:27:02 2012 +0100

    [CLEANUP] Adjust code to CGL and fix small namespace bugs
    * whitespaces, tabs and blank line issues
    * bool -> boolean
    * int -> integer
    * fix wrong namespace annotations
    Fixes: #43157
    Releases: 6.0
    Change-Id: I8397948e19248db029d8efd1555ee56e4982742d
    Reviewed-by: Helmut Hummel
    Tested-by: Helmut Hummel

commit 55f151588674c0c3ab3bf5636729f1991a5d1dac
Author: Wouter Wolters <*****>
Date:   Sat Apr 13 09:54:20 2013 +0200

    [TASK] Remove further t3lib mentions
    Change-Id: I0e82b92e9e3ad0decd93c4fc70cec34cb6a90c31
    Resolves: #47176
    Releases: 6.1
    Reviewed-by: Christian Kuhn
    Tested-by: Christian Kuhn

commit 8ccaa84e9127d28f9bf008930bccea53d55aca93
Author: Alexander Schnitzler <*****>
Date:   Sun Apr 14 13:23:42 2013 +0200

    [BUGFIX] Fluid must not use legacy flash message handling
    Since the core introduced a new flash message handling the
    handling in Fluid has to be adjusted as well.
    Releases: 6.1
    Resolves: #47214
    Change-Id: I490f77687befa1a62db0718f828fce1e68ebdfff
    Reviewed-by: Marc Bastian Heinrichs
    Tested-by: Marc Bastian Heinrichs
    Reviewed-by: Wouter Wolters
    Tested-by: Wouter Wolters
    Reviewed-by: Alexander Schnitzler
    Tested-by: Alexander Schnitzler

commit fae04a024687fd061c41d67076cfb455d189aefc
Author: Christian Kuhn <*****>
Date:   Wed May 1 17:57:52 2013 +0200

    [BUGFIX] Mentions of old class names
    Change-Id: Iee7a863a9d68d1379e1e616414b9848e0c535a8a
    Resolves: #47791
    Releases: 6.2
    Reviewed-by: Christian Kuhn
    Tested-by: Christian Kuhn

commit 77f29a3c69a7cbb27b34072754aa503bace6c9f1
Author: Christian Kuhn <*****>
Date:   Tue Oct 1 14:40:56 2013 +0200

    [TASK] Remove closing PHP tags
    Change-Id: Iaa92566c53301e49396fc9fb26b0b339c48d567b
    Resolves: #52360
    Releases: 6.2
    Reviewed-by: Christian Kuhn
    Tested-by: Christian Kuhn
    Reviewed-by: Ernesto Baschny
    Tested-by: Ernesto Baschny
    Reviewed-by: Anja Leichsenring
    Tested-by: Anja Leichsenring