This plugin was dropped in Struts 2.5, instead please use Tiles Plugin which was extended and upgraded to Tiles 3.

Tiles is a templating framework designed to easily allow the creation of web application pages with a consistent look and feel. It can be used for both page decorating and componentization. This is the first release of the plugin!

The Tiles 3 pluginallows actions to return Tiles 3 pages.


  • Supports Tiles in Freemarker, JSP, and Velocity - more testing is needed


The following steps must be taken in order to enable Tiles 3 support within your Struts2 application:

  1. Include the struts-tiles3-plugin as a dependency in your web application, do not include the old struts2-tiles-plugin! If you are using maven3, the dependency configuration will be similar to:

  2. Register the tiles listener.

  3. All package definitions which require tiles support must either extend the tiles-default package or must register the Tiles 3 Result type definition.

      <result-type name="tiles" class="org.apache.struts2.views.tiles.TilesResult"/>
  4. Configure your actions to utilize a tiles definition:

    <action name="sample" class="org.apache.struts2.tiles.example.SampleAction" >
      <result name="success" type="tiles">tilesWorks</result>




This plugin does inherits settings from Tiles configuration.


This plugin can be installed by copying the plugin jar into your application's /WEB-INF/lib directory. No other files need to be copied or created.

  • No labels