Install the Geocortex Viewer for HTML5

Installation Methods

There are two ways to install the Geocortex Viewer for HTML5 framework:

The method that you choose has important implications for how you manage your viewers. Read about the two options below before making a decision. Choose the method that best suits your needs and follow the instructions for that method.

Installation Using a Viewer Template

This method allows you to:

See also...

Install the Viewer Framework Using a Viewer Template

Manual Installation

This method is for expert users with a good understanding of web servers and a willingness to manage their viewers by hand.

When you install a viewer manually, the viewer is not integrated with Manager. This means that it does not appear in your site configuration. To configure the viewer, you must manually edit the viewer's configuration files. Manual configuration is prone to error. If you introduce an error into a configuration file, the viewer may not run. You cannot use Essentials to upgrade manually installed viewers.

The viewer can be deployed using any web server. With most web servers, simply place the contents of the installation package into a folder that is known to the web server. This is enough to get the viewer application up and running.

Manual installation allows you greater control than installation using the viewer template. It allows you to:

See also...

Install the Viewer Manually

Install the Viewer Framework Using a Viewer Template

These instructions describe the steps to install the Geocortex Viewer for HTML5 using a viewer template.

If you are installing the HTML5 Viewer as part of a new installation of Geocortex Essentials, you must install Essentials first.

Installation is done using the EssentialsPost-Installation Configuration tool. There are three main steps:

You can add the template to the Post-Installation Configuration tool without installing the Management Pack or deploying the viewer template to IIS. You can install the Management Pack later using the Post-Installation Configuration tool's Deploy Management Pack button. Similarly, you can deploy the viewer template to IIS later using the Deploy Template to IIS button.

After adding the template, click the template to show the buttons

To install the Geocortex Viewer for HTML5 using Geocortex Essentials:

  1. Launch the Post Installer.

  2. Click Configure Templates in the side panel.

  3. Click Add.

  4. Browse to the folder where you extracted the files from the installation package.

  5. Select the template file (.vte file), and then click Open.

    You are prompted to install the Management Pack.

  6. Click Yes.

    You are prompted to deploy the template to an IIS virtual directory.

  7. Click Yes.

    The Deploy Template to IIS dialog box opens.

    Deploy Template to IIS dialog box

  8. If you want to deploy the viewer to a website that does not exist yet, create the website in IIS.

  9. In the Select Web Site box, select the website that you want to deploy the viewer to.

  10. In the Select Virtual Directory box, type a name or path for the virtual directory where you want the viewer to be deployed.

    The URL in the box below the Select Virtual Directory box updates as you type the virtual directory.

    The virtual directory must not already exist. Essentials will create the web folder needed to deploy the viewer.

    The URL you register with Essentials must have the same domain as Essentials—the viewer cannot launch or load configuration from a different domain.

  11. If you want to be able to launch the viewers that are based on this template from Manager, make sure the Register URL with Manager checkbox is selected.

    If you clear the Register URL with Manager checkbox, the viewer launch links do not appear in Essentials. You will still be able to use Essentials to add and configure viewers.

  12. If the URL beside the checkbox is not fully qualified, replace it with the fully qualified URL.

    A fully qualified URL specifies the host and domain, for example, A URL that omits the domain is not fully qualified.

    If you do not specify the fully qualified URL here, the viewer will initially be blank when you launch it from Manager—you will have to manually enter the fully qualified URL in your browser's address bar to see the map. Also, Manager's Preview links will not work.

    Geocortex Essentials 3.11.1 and later versions provide the fully qualified URL by default.

  13. Click Deploy, and then close the success message that displays.

    The template is listed in the Installed Templates area.

  14. Click Finish. If prompted to review your settings, click OK, and then click OK again to close the Post Installer.

Add a Viewer to a Site

To add an instance of the HTML5 Viewer to an Essentials site:

  1. Click the Windows Start button, type Essentials, and click Geocortex Essentials Manager.

  2. If you are prompted to sign in, enter your user name and password, and then click Sign In.

    Depending on how Essentials is configured in the Post Installer, you either sign in using an ArcGIS account or a Windows account.

    Manager opens to the Site List.

    If no sites exist, add a new site.

  3. Edit the site that you want to add a viewer to.

  4. In the sidebar, click Viewers.

    The Viewers page opens.

  5. Click Add Viewer.

    The Create New Viewer dialog box opens.

    Create New Viewer dialog box

  6. In the Display Name box, type a name for the viewer.

    Avoid long viewer display names. Display names affect Windows file paths, which must be less than 260 characters.

    We recommend using a unique display name for the viewer to prevent confusion.

  7. In the Template box, select Viewer for HTML5 4.14.0 from the drop-down list.
  8. Click OK.

    The Create New Viewer dialog box closes and Manager's Viewer Info page opens.

    Manager's Viewer Info page showing the new viewer

  9. To verify your installation, launch the viewer from Manager.

    Manager provides several methods of launching the viewer, including:

    If the viewer does not load in the browser window, edit the URL in the address bar to fully specify the server and domain, for example, If the URL uses just the server name, the viewer will not display in some cases.

    HTML5 Viewer's Handheld interface

Install the Viewer Manually

These instructions describe the steps to manually install the Geocortex Viewer for HTML5.

In the method described here, the Viewer files are placed in a subfolder of IIS's wwwroot folder. Alternatively, you could create an IIS virtual directory that maps to the folder where the Viewer files are stored.

To install the HTML5 Viewer manually:

  1. Create a folder in a location that is known to your web server.

    For example, you could create a folder named HTML5Viewer in the following location:


  2. Extract the files from to the new folder on your web server. is provided in the installation package.

    Contents of

You have installed an instance of the HTML5 Viewer. The next step is to verify the installation by launching the viewer.

Launch a Manually Installed Viewer

There is an HTML file in the deployment folder for each class of device that can be used to run the viewer:

By default, the HTML5 Viewer is configured to target a World Cities site on a sample Geocortex server.

To verify your installation:

  1. Launch the viewer in your browser using the Desktop interface.

    For example, if you deployed the viewer to C:\inetpub\wwwroot\HTML5Viewer, type http://localhost/HTML5Viewer/Index.html in your browser's address bar.

    Out-of-the-box HTML5 viewer showing a sample site in the Desktop interface

  2. Launch the viewer in the Handheld interface.

    The URL is http://localhost/[deployment folder]/Handheld.html.

  3. Launch the viewer in the Tablet interface.

    The URL is http://localhost/[deployment folder]/Tablet.html.

Point a Manually Installed Viewer to Your Site

Each HTML5 viewer has three configuration files, one for each class of device that can run the viewer:

To make the viewer point to your site rather than the sample site, you need to change the siteUri property in each of the viewer's three configuration files.

To configure the viewer to target your site:

  1. Open the three configuration files in a text editor.

    The configuration files are in [deployment folder]/Resources/Config/Default, where [deployment folder] is the folder on your web server where you deployed the viewer. By default, the HTML5 Viewer is deployed to:


  2. In each configuration file, update the siteUri property to point to your site. For example:

    "siteUri": ""
  3. Save the configuration files.

  4. To test the three configurations, launch each one in a browser.

© 2021 VertiGIS North America Ltd. All Rights Reserved.

Documentation Version 4.14