Using GISFaces™ is easy. With the instructions below, you should be up and running in no time.



  • Download the latest GISFaces release.
  • The downloaded .zip file contains the library .jar, JavaDoc .jar, examples .war, and documentation .pdf files.
  • Copy the gisfaces .jar file to your project's WEB-INF/lib directory.
  • No configuration or setup is required.

Create a web page:

  • The easiest way to get started is to use an .xhmtl page from the examples .war file.
  • The simple.xhtml page from the examples .war file is shown below.


  • Add the namespace xmlns:gis="" to your page.
  • Add a gis:map component to your page.
  • Add zero or more gis:service components to the gis:map component.
  • Add zero or more gis:layer components to a gis:service component.

Run all examples from the provided .war file:

  • Deploy the gisfaces examples .war file to your local Java container. Try Glassfish or Tomcat if you need one.
  • Open a browser using an address similar to http://localhost:8080/gisfaces-examples-1.9.0
  • Run the example map of your choice!