Tooltips

Tooltips control what appears when someone hovers a feature on the map.

In Topologis, tooltip settings belong to the project. That means the same tooltip configuration is used across the project’s views, shared links, and embeds.

How tooltips work

Tooltip settings are configured in the Tooltips tab of the project editor.

The current model has three parts:

• An optional tooltip title
• A list of enabled data fields
• A shared tooltip style

Tooltips only render when there is something usable to show. If a feature has no usable title and no enabled tooltip fields, Topologis does not display an empty tooltip.

Choose a title field

You can turn the tooltip title on or off and choose which field should be used for that title.

The title field selector supports:

• Auto
• Any available field found across the project’s layers

Auto is a special mode. In the current renderer, it looks for a usable value in name, then title, then id. If you choose a specific field instead, that field must exist and contain a usable value for the title to appear.

Show or hide fields

The fields section lists all available properties found across the project’s layers.

Each field can be enabled or disabled for tooltip output. This gives you a simple way to keep tooltips focused on the fields that matter, instead of exposing every property that came in with the data.

If a configured field is no longer present in any layer, Topologis keeps the override and marks that field as missing in the editor instead of silently deleting the configuration.

Rename fields in the tooltip

Each enabled field can have its own tooltip label.

If you leave the label blank, Topologis uses the original field name. If you set a custom label, that label is used both in the rendered tooltip and in places where tooltip field labels help describe map output.

Each field can also use an explicit display type:

• Auto
• String
• Number
• Date
• Boolean
• JSON

Auto is the most flexible option when the raw field values are already consistent. Explicit types are useful when you need predictable formatting.

Format numbers and currencies

For number fields, Topologis supports three formatting styles:

• Decimal
• Currency
• Percent

Depending on the selected style, you can configure:

• Currency code
• Minimum and maximum fraction digits
• Grouping
• Notation
• Sign display
• Multiplier

This lets you turn raw source values into clearer output, such as scaled percentages, compact large numbers, or currency values with a fixed precision.

Format dates and time zones

For date fields, Topologis lets you control how date and time values are formatted in the tooltip.

The current date settings include:

• Locale
• Time zone
• Date style
• Time style
• 12-hour or 24-hour clock

This is useful when the source data uses timestamps but the audience needs a specific locale or time zone in the final map.

Set null and empty-value labels

Each field can define its own fallback labels for missing or blank values.

The current advanced field settings include:

• Null Display
• Empty String Display
• Prefix
• Suffix

Use these settings when the raw data contains blanks, nulls, or values that need a short unit or label added around them.

Style the tooltip

Tooltip appearance is configured once at the project level.

The current tooltip style controls are:

• Font size
• Font color
• Padding
• Background color
• Border radius
• Border width
• Border color
• Shadow

These settings control the overall tooltip container rather than individual fields. If you want the map content and labels to read more consistently together, pair this page with Styles.