Skip to content

Table of Contents

The Table of Contents, briefly TOC from now on, is a space where all the layers and the layers groups are listed. Through this panel it is also possible to carry out the following operations:

  • Add and remove layers and groups

  • Perform a search between layers

  • Change the position (and consequently the display order in map) of layers and groups

  • Set some display options directly from the panel

  • Manage layers and groups and query layers through the toolbar actions

Add and remove layers and groups

The user can access the TOC with the Layers button on the top-left corner of the map viewer. For example, in a new map, the following panel appears:

The Add Layer button opens the Catalog, a panel where it is possible to choose the desired layer and add it to the map with the Add to Map button :

Once the layer is added to the map, the result should be like the following:


When a layer is added for the first time to the TOC, without any group present, the Default group is created. This group host all the layers that don't belong to a specific group and can also host sub-groups within it.

In order to add a new group, clicking on the Add Group button the following window opens:

Once the name of the group is typed, with the button the new group is added to the TOC.

In order to add a new layer to a specific group, it is possible to select that group and click on Add layer to selected group :

In order to add a subgroup inside a specific group selected, the user can click on the Add sub group to the selected group button (maximum 4 subgroup levels are allowed):

Layers and groups can be removed selecting them and clicking on the Remove button present in the toolbar of each selected layer and group.


When a group is removed, also all the layers and subgroups associated with it will be removed.

Search for layers

With the TOC it is also possible to perform a search between the added layers. This operation can be done simply by typing the name (o part of it) of the layer in the search bar:

Choose layers and groups position

With the drag and drop it is possible to change layers position inside the same group, but also moving them between different groups. Once the Default group is created, all the layers without a specific group are automatically added to this one. Changing layers position with the drag and drop, for example, it can display like the following:

Groups and sub-groups, no matter their level, can be nested inside other groups and sub-groups, or can be separated from their parent-level to create new main groups. These operation can be performed, again, with the drag and drop function.


The only constraints applied to the groups manager refer to the Default group (each layer added to the map the first time is included in that group). Drag and Drop operations are not allowed for the Default, but it's allowed to rename it or to nest groups or sub-groups inside it.

Layers position can also be determined through the Selected layer settings button available in the toolbar that appears once a layer is selected. This button opens a panel where the user can choose the destination group (or subgroup):

Display options in panel

Directly from the TOC panel, it is possible to set different types of display options. In particular, for layers, it is possible to:

  • Toggle layers visibility by switching on and off the "eye" icon to the left of the layer name

  • Expand or collapse the legend by clicking on the icon. The width and height property of the legend can be overridden via Legend options under Display tab.

  • Control the transparency in map by scrolling the opacity slider


When the user switch off the visibility of a layer, also the group where that layer is nested change the "eye" icon in (no matter if other visible layers are present in that group)

With groups there's the possibility to:

  • Expand or collapse the list of layers or subgroups nested inside it

  • Toggle groups visibility by switching on and off the "eye" icon to the left of the group name


When the user switch off the visibility of a group, also the visibility of all the layers and subgroups nested inside it will be automatically switched off.

Toolbar options

Once a group is selected the following toolbar appears:

Through this toolbar it is possible to:

  • Add layer to selected group : it is possible to add one or more layers to the group

  • Add sub group to the selected group : it is possible to add one or more sub-groups to the selected group

  • Zoom to selected layers extent : in order to zoom the map to all layers belonging to the group

  • Open the Selected group settings where it is possible to change the group's title, the title translations and see the group name (its ID). It is also possible to add/customize the description of the group and configure the tooltips placement in the UI (more information can be found in Layer Settings section)

  • Remove selected group and its content

Once the changes have been made, it's possible to save them through the Save button .


The information thus modified will be kept only within the current user session. In order to make these kinds of changes persistent across different user session, the map needs to be saved.

Selecting a layer, the toolbar is the following one:

In this case the user is allowed to:

  • Zoom to selected layer extent : in order to zoom the map to the layer's extent

  • Access the selected Layer Settings

  • Set a Filter for that layer

  • Access the Attribute Table

  • Remove the selected layer

  • Create Widgets for the selected layer

  • Export the data of the selected layer

  • Open the Layer Metadata (if configured), to retrieve layer metadata from the remote catalog source.


The Metadata Tool is not configured by default in MapStore. A complete documentation to configure it is available as part of the TOC Plugins documentation (see metadataOptions). Once the Metadata Tool has been configured, MapStore is able to load the layer metadata from the remote CSW service and parse it to be presented to the user according to the provided plugin configuration. This functionality automatically works in case of WMS layers coming from a CSW catalog source, while for layers coming directly from a WMS catalog source the Metadata Link must be present in the WMS Layer GetCapabilities.

  • Open the Compare tool where it is possible to Swipe or Spy the selected layer .

From the dropdown menu of the Compare tool it is possible to click on button so that the Swipe tool is enabled on the map for the selected layer: to activate the Swipe it is also possible to simply click on the Compare tool button.

From the Compare tool dropdown , it is also possible to click on . Doing this a configuration modal opens for the selected Compare tool (Swipe or Spy glass) so that, in case of Swipe, the user can change the orientation of the swipe from Vertical to Horizontal.

The user can also activate the from the same dropdown menu in order to switch the Compare tool in Spy glass mode. If the Spy glass is active, clicking on the option, the configuration modal opens so that it is possible to change the size of the spy glass (the radius).