Whatever message this page gives is out now! Go check it out!

cfmapitem

Last update:
May 18, 2026

Description

The cfmapitem tag is a child tag of the cfmap tag. This tag creates markers on the map. You can specify the marker in a map using either the cfmapitem tag or using the ColdFusion.Map.AddMapMarker JavaScript API. See ColdFusion.Map.addMarker for details.

Category

Display management tags

Syntax

<cfmapitem 
address="address" 
latitude="latitude in degrees" 
longitude="longitude in degrees" 
markercolor="marker color" 
markericon="icon path " 
markerwindowcontent="content" 
name="name of the map" 
showmarkerwinodw="true|false" 
showUser="true|false" 
tip="marker tip" />

See also

cfdiv cfwindow, cfmap

History

ColdFusion 10: Added the attribute {{showUser}}
ColdFusion 9: Added this tag.

Attributes

Attribute
Req/Opt
Default
Description
address
Required, if latitude and longitude are not specified
The address of the location to set the map marker.
latitude
Required, if address is not specified
The latitude value for the marker, in degrees. The valid values for latitude are -90 to + 90.
longitude
Required, if address is not specified
The longitude value for the marker, in degrees. The valid values for longitude are -180 to + 180.
markercolor
Optional
green
The color of the marker specified as a hexadecimal value. By default, the centermarker is green in color.

The attributes markericon and markercolor are mutually exclusive.
markericon
Optional
Location of an image file to use as the marker icon. The attributes markericon and markercolor are mutually exclusive.
markerwindowcontent
Optional
Static content displayed in the marker window. This attribute ignores the markerbind attribute defined in the tag cfmap.
name
Optional
The name of the map.
showmarkerwindow
Optional
Inherits parent cfmap setting
If set to true, displays the marker window. If the attribute markerbind is used, unless you set this attribute to true, the marker window is not displayed.
showUser
Optional
false
If set to true, on HTML-compliant browsers, user location is shown on the map.
tip
Optional
A short description of the marker location that appears as a tool tip.

Usage

This tag must be used within the cfmap tag.

The following inheritance rules apply:
  • The value specified for the attribute showmarkerwindow in the cfmap tag is inherited by all cfmapitem tags.
  • A child cfmapitem tag can override the attribute showmarkerwindow in the cfmap tag by changing the value.
  • Any bind expression defined using the markerbind is ignored if the cfmapitem tag defines the attribute markerwindowcontent.

Examples

<h3>cfmapitem example using latitude and longitude attributes</h3> 
<cfmap name="gmap01" 
centerlatitude="71.094224" 
centerlongitude="42.339641" 
doubleclickzoom="true" 
overview="true" 
scrollwheelzoom="true" 
showscale="true" 
tip="My Map" 
zoomlevel="4"> 
<cfmapitem name="marker01" 
latitude="70.50" 
longitude="42.50" 
tip="New marker"/>
<h3>cfmap Example using address address</h3> 
<cfmap name="gmap02" 
centerlatitude="71.094224" 
centerlongitude="42.339641" 
doubleclickzoom="true" 
overview="true" 
scrollwheelzoom="true" 
showscale="true" 
tip="My Map" 
zoomlevel="4"> 
<cfmapitem name="marker02" 
address="345 Park Avenue, san jose, CA 95110-2704, USA" 
tip="New marker"/>

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page