Markup Module

The Markup Module implements the ability for end users to add markup text and shapes to the map. Markup is added to the map's drawing layer. The drawing layer does not appear in the layer list.

Markup exists only for the duration of the session—when the user closes the viewer, the markup disappears. To save markup across sessions and share it with other users, a signed-in user can save a project, provided the viewer supports projects. For information about projects, see Project Module.

The Markup Module is integrated with the Measurement Module. For more information on how measurements affect this module, see the section Markup Measurement.

Drawing creation tools and editing tools in the Desktop and Tablet interfaces

Drawing creation tools and editing tools in the Handheld interfaces

Text markup limitation:
The styling options for the halo (outline) effect on text markup (color and width) are not available if the viewer is used with Internet Explorer 11. Text halo styling options are available in all other supported browsers. See Client Requirements for information about supported browsers and devices.

Edit Drawings on the Map

The capability to include and provide editing of drawings on a map tip is dependent on "enabled" set to true on the GraphicsLayerIdentifyProvider in the configuration of the Identify module. If enabled is set to false, the include and edit capability on a map tip is not available.

When a user adds a drawing to the map:

When the drawing is in edit mode:

The user can also click a measurement drawing or a collaboration graphic to place it in edit mode. For more information, see Collaboration Module and Measurement Module.

Note that drawings, measurement drawings, and collaboration graphics are included in the results of an identify operation.

Editing Tools

Clicking a drawing to access the editing function via the map tip is preferable to using the Edit Drawings multitool in the toolbar.

Edit Drawings in the toolbar allows the user to edit, erase, or clear drawings. Note that using Erase on drawings that overlay each other erases all of the drawings. To avoid this behavior, the user can click one of the drawings to open the map tip, select the drawing to be deleted from the drop down list, and click Delete.

Edit tools for drawings in the Desktop and Tablet interfaces

Edit tools for drawings in the Handheld interfaces

Configure the Toolbar

The Markup Module provides tools for working with markup. These tools are not in the default toolbar—you must add them to the toolbar. If you use the Web GIS (Full )Toolbar, the markup tools are available in the Draw section on the Tools tab. For instructions on adding tools to the toolbar, see Toolbar.

The Markup Module makes the following tools available:

The Drawing and Edit Drawing groups are included on the Web GIS (Full) Toolbar preset.

Markup Styles

When a user clicks a drawing to place it in edit mode, they can click Styles in the map tip to open the Select Drawing Style panel. Each type of drawing has a specific set of style options to choose from.

For example, to change from the default point style to an enlarged, angled image point style:


Default point style on a map


Image point style on a map

  1. Click Styles in the map tip to open the Select Drawing Style panel.

  2. Select Choose an image in the Type drop down list.

  3. Click a black pin image.

  4. Change Image Size from 32 px to 45 px, and Angle from 0 degrees to 60 degrees.

  5. Click Done to apply the style changes to the point image on the map.

The following image illustrates different markup drawings and their styles. You can edit the styles or add your own custom styles in the Module configuration.

Different types and styles of markup

Measurement Markup

Markup made by the Measurement Module can be edited and styled like any other markup. If edited, measurements are recalculated and re-drawn on the map showing the new measurements.

You can move, resize and rotate lines, polygons and text markup. Points can only be moved. Text can be edited.

If several drawings overlay each other, click the top-most drawing to place it in edit mode and to open the map tip. In the map tip, select the drawing you want to edit from the drop-down list or use the next page or previous page arrows to go to the pages for the drawings.

Export Drawings

The Export Drawings tool extracts the markup layer and creates an file containing all of the drawings. This feature is enabled only after markup has been added to the map in the viewer.

When the Edit Drawings tool is enabled, the Export Drawings tool is disabled. When the user selects the Export Drawings tool, a confirmation dialog box appears. Once accepted, the file is saved to the user's device.

The shapefile format is a vector data format for GIS software developed by Esri. Shapefiles support point, line, and area features. A valid shapefile requires one .shp file as well as a .shx and .dbf file. For more information, see Esri's technical specification for shapefiles.

The contains the user's drawings as shapefiles. Separate shapefiles are exported for each type of drawing. For example, if a map contained multiple point drawings and multiple polygon drawings, the export will contain a combined point.shp file and a combined polygon.shp file. Combined shapefiles can have the following names:

In addition to a .shp file, the exported shapefiles consist of a .cpg, .dbf, .prj, and a .shx. All five of these files are required.

Exported shapefiles do not include measurement markup, although the geometry values and scale will be preserved. Similarly, exports do not include text or drawing styles from the markup layer.

Copy to Drawing Layer

If a feature is selected and the panel displays its feature details, the user can use the Feature Actions Menu to access the Copy to Drawing Layer action. This copies the geometry of the selected feature to the drawing layer. You can then interact with a markup version of the feature in the same way that you would interact with and edit other markup on the map.


The Export Drawings feature can be configured to the I Want To menu with the ExportMarkupLayer command. For instructions, see I Want To Menu. The ExportMarkupLayer command calls the ExportGraphicsLayer command, which exports any markup in the form of extents, multipoints, points, polylines, and polygons.

Configuration Properties


No configuration properties


No views

View Models

© 2021 VertiGIS North America Ltd. All Rights Reserved.

Documentation Version 4.14