Pushpins are not currently supported in the Handheld interface. Adding pushpin configuration to the Handheld configuration file has no effect.
The Pushpins page in Manager includes settings that control the appearance of pushpins that appear on the map. When pushpins are visible, they are placed in the center of a feature, subject to any configured offset.
Pushpins are visible for a point feature when:
The pointer is placed on the entry in the Results List.
The feature details panel is open.
A maptip for the feature is open.
Pushpins are visible for a line and/or polygon feature when:
The feature is not visible in the current map scale and the pointer is placed on the entry in the Results List.
The feature details panel is open.
A maptip for the feature is open.
Otherwise, the feature is highlighted in yellow. If you place the pointer on a specific item in the list, the highlight color changes to blue on the map.
In the following example, a search for “smith” results in a list of street names, and their locations are highlighted in yellow on the map. Since the scale of the map does not show sufficient detail for the listed items, a pushpin identifies the location of the feature when the pointer is placed on that item in the list, and the highlight color changes to blue.
Highlighted line features and a pushpin on the map for the item in focus in the list
When the map zoom level is increased, the features remains highlighted in yellow. When focus is placed on the item in the list, the highlight color for that item changes to blue on the map, however a pushpin does not appear.
Feature on the map highlighted in yellow for the entry in the list
Feature on the map highlighted in blue when focus is on the entry in the list
If you add markup to a map that has pushpins displayed, the markup appears behind the pushpins by design.
Pushpins are supported with geocoders and workflows.
To open an HTML5 viewer's Pushpins page in Manager:
In beside the viewer.
In the side panel, click Pushpins.
The Pushpins page opens.
The Pushpins page has the following settings:
Enabled: If you want pushpins to appear for each feature of the search results, select this checkbox. By default, this checkbox is selected.
Pushpins Remain Visible When Results List Inactive: If you want pushpins to remain visible when a view other than the Results List or Results Table activates, select this checkbox. By default, this checkbox is selected.
In versions prior to the HTML5 Viewer 2.6, the default behavior was to hide pushpins when a view other than the Results List or Results Table activates. If you want the previous default behavior, clear this checkbox.
This option has been deprecated effective with Geocortex Essentials 4.7 as a result of changes implemented in highlighting.
Pushpin Image: The URL to the image that represents the pushpin. Type the URL in the text box. Alternatively, click Browse to use an image on the server; if necessary, upload an image to the server by clicking Upload and selecting an image file to upload. The default is a red pushpin image located at Resources/Images/Pushpins/map-marker-red-32.png. Other colors available out-of-the-box include blue, green, purple and yellow.
Pushpin Marker Width: The width of the pushpin in pixels. This is typically set to the width of the pushpin image, otherwise the image will be scaled. The default is 32.
Pushpin Marker Height: The height of the pushpin in pixels. This is typically set to the height of the pushpin image, otherwise the image will be scaled. The default is 32.
Offset X: The number of pixels to horizontally offset the pushpin image. In other words, the distance along the X-axis between the center of the feature and the center of the pushpin image. Use a negative integer to place the pushpin to the left of the feature's center. The default is 0.
Offset Y: The number of pixels to vertically offset the pushpin image. In other words, the distance along the Y-axis between the center of the feature and the center of the pushpin image. Use a negative integer to place the pushpin below the feature's center. The default is 16, because the pointer is at the bottom of the default image, which is 32 pixels high.
![]() |
![]() |
See also...