How to split faces-config.xml into multiple files?


In JSF, the faces-config.xml file can used to includes manages beans, navigation rules or any JSF faces configurations. But, putting all the configurations into a single faces-config.xml file will cause this file become huge very fast, and causing a serious maintainability issue.


Actually, you can split the faces-config.xml into multiple smaller files, each group by related settings. For example, group by module, managed beans, navigation rule, faces configurations in different XML files. See figure below :


Then declared all the XML files in javax.faces.CONFIG_FILES initialize parameter, which inside the WEB-INF/web.xml file.

<web-app ...>
For Struts developer, this is the exact classic problem happened in the Struts configuration file as well.
Tags :

About the Author

Founder of and, love Java and open source stuff. Follow him on Twitter, or befriend him on Facebook or Google Plus. If you like my tutorials, consider make a donation to these charities.


  • Pingback: alkaline water brands()

  • Pingback: paypal loans()

  • Pingback: alkaline water machine()

  • Pingback: water ionizer machines()

  • Pingback: car parking()

  • Pingback: her og nu laan()

  • Pingback: youporn()

  • Pingback: parking()

  • Pingback: Direct TV vs Cable TV()

  • Pingback: DIRECTV packages()

  • Pingback: Blue Coaster33()

  • shareef

    SEVERE: Exception while loading the app
    java.lang.Exception: java.lang.IllegalStateException: ContainerBase.addChild: start: org.apache.catalina.LifecycleException: com.sun.faces.config.ConfigurationException: CONFIGURATION FAILED! PWC1223: Path WEB-INF/manage-beans.xml does not start with ‘/’

    from downloaded source i fixed by adding an extra ‘/’ at begining of WEB-INF/manage-beans.xml

  • yaswanth

    nice tutorial sir

  • Dileep

    Hi mkyong,
    how to get the code assistance in eclipse if use multiple faces-config.xml files, Plz help me….

  • Abhishek


    When I put this file into web.xml file.Component class get skipped by the compiler.And directly render the tag .Actually I am making custom tag in jsf2.0

    And when I remove the above code from web.xml
    In all my pages

    This line get shown up

    Please give me solution for it

  • Pingback: JSF 2.0 Tutorials()