Floating Labels

Map geometry alone is not enough to have a sense of a location. Let's add labels to name the stores and other points-of-interest in the Mappedin Demo Mall. We can add the Floating Labels with default styles easily with FloatingLabels.labelAllLocations().

However, this sample CodeSandbox does a bit more than just render the labels in the beginning. Try clicking on a polygon to see a styled label and outside of interactive polygons to reset the labels.

Styling Options

The following type declaration of appearance object describes the customizable attributes.

type TFloatingLabelAppearance = {
margin?: number;
marker?: {
backgroundColor?: { active?: string; inactive?: string };
foregroundColor?: { active?: string; inactive?: string };
size?: number;
icon?: string;
iconVisibilityThreshold?: number;
text?: {
backgroundColor?: string;
foregroundColor?: string;
lineHeight?: number;
maxWidth?: number;
numLines?: number;
size?: number;


  • Margin in pixels around the label and marker. This will affect label density

Text styles:

  • Text size in pixels
  • If the text spans multiple lines, this sets the maximum number of lines to display
  • Maximum width of text in pixels
  • Line height sets the height of a text line box, by default it is set to 1.2
  • Text has a foreground and background colors that can be set like CSS colors #333 as Hex string or the CSS name of a color such as crimson

Marker styles:

  • Size of the marker in pixels
  • The marker takes both active and inactive variants of its foreground and background colors

The label created by clicking on a polygon is styled to have a larger marker and larger, more colorful text.

mapView.FloatingLabels.add(polygons[0], location.name, {
appearance: {
marker: {
size: 20
text: {
size: 32,
foregroundColor: "#ffb702",
backgroundColor: "#0a0a0a"

Labels can be removed individually using FloatingLabels.remove(polygonOrNode) or all at once with FloatingLabels.removeAll().

Adding Icons

Icons can be added to Floating Labels to highlight certain categories or to make locations more eye catching. They become visible as the user zooms into the map to view more detail. The supplied icon must be an SVG provided to the TFloatingLabelAppearance options in FloatingLabels.add().

We can use the list in the MappedinVenue object to iterate through locations and add icons. At the same time, we'll color the markers surrounding the icon based on their category since we have only one icon in this demonstration.

const colors = ["dodgerblue", "pink", "green", "orange", "tomato", "gray"];
venue.categories.forEach((category, index) => {
category.locations.forEach((location) => {
if (location.polygons.length <= 0) {
const color = colors[index % colors.length];
mapView.FloatingLabels.add(location.polygons[0], location.name, {
appearance: {
marker: {
icon: `<svg width="92" height="92" viewBox="-17 0 92 92" fill="none" xmlns="http://www.w3.org/2000/svg">
<g clip-path="url(#clip0)">
<path d="M53.99 28.0973H44.3274C41.8873 28.0973 40.7161 29.1789 40.7161 31.5387V61.1837L21.0491 30.7029C19.6827 28.5889 18.8042 28.1956 16.0714 28.0973H6.5551C4.01742 28.0973 2.84619 29.1789 2.84619 31.5387V87.8299C2.84619 90.1897 4.01742 91.2712 6.5551 91.2712H16.2178C18.7554 91.2712 19.9267 90.1897 19.9267 87.8299V58.3323L39.6912 88.6656C41.1553 90.878 41.9361 91.2712 44.669 91.2712H54.0388C56.5765 91.2712 57.7477 90.1897 57.7477 87.8299V31.5387C57.6501 29.1789 56.4789 28.0973 53.99 28.0973Z" fill="white"/>
<path d="M11.3863 21.7061C17.2618 21.7061 22.025 16.9078 22.025 10.9887C22.025 5.06961 17.2618 0.27124 11.3863 0.27124C5.51067 0.27124 0.747559 5.06961 0.747559 10.9887C0.747559 16.9078 5.51067 21.7061 11.3863 21.7061Z" fill="white"/>
<clipPath id="clip0">
<rect width="57" height="91" fill="white" transform="translate(0.747559 0.27124)"/>
foregroundColor: {
active: color,
inactive: color,

The combination of color and icons creates a very attractive appearance for the labels that stands out on the map.

If you only wish to highlight a few locations using icons and apply a default appearance to the rest, you can do this by applying FloatingLabels.labelAllLocations() before overriding with FloatingLabels.add() as we did above.

Preset Themes

Mappedin Web SDK comes with two preset Floating Label themes. labelThemes.darkOnLight is rendered by default. However, darker page themes might sometimes be preferable and the darker labels might look better. Use the dark mode themed labels by importing them and setting the appearance when labeling locations.

import { labelThemes } from "@mappedin/mappedin-js";
appearance: labelThemes.lightOnDark

The appearance settings can be overridden but this theme provides a solid starting point for a darker visual style.

Was this page helpful?

Next Topic

Flat Labels