Filter Types Reference

Filter types

Filters let your map visitors narrow down features based on specific criteria. Mapsemble offers several filter types, each designed for different data types and interaction patterns.

Reference table

Filter type details

Text

A free-text search input. Users type a query and features are filtered by matching against the linked field's values. Best for general-purpose search across text fields.

• Compatible fields: text, multiline_text
• Handler type: field
• Configuration: placeholder text, label, icon

Autocomplete

A type-ahead search input that suggests matching values as the user types. Suggestions are drawn from existing values in the linked field. Ideal when users need to find a specific known value.

• Compatible fields: text, multiline_text
• Handler type: field
• Configuration: placeholder text, label, icon

Integer

Filters by exact integer value. Use when you need precise numeric matching without decimals.

• Compatible fields: number
• Handler type: field
• Configuration: placeholder text, label, icon

Number

A general numeric filter. Suitable for filtering number fields without specific precision requirements.

• Compatible fields: number
• Handler type: field
• Configuration: placeholder text, label, icon

Decimal

A numeric filter with decimal precision. Use when your data requires exact decimal matching.

• Compatible fields: number
• Handler type: field
• Configuration: placeholder text, label, icon

Range

A slider control that lets users select a min/max range. Ideal for price ranges, distances, ratings, or any numeric value where users want to set bounds.

• Compatible fields: number
• Handler type: field
• Configuration: placeholder text, label, icon, min/max bounds

Options

Displays predefined options as checkboxes or buttons. Users can select one or more options to filter features. The options are derived from the linked select field's configured values.

• Compatible fields: single_select, multi_select
• Handler type: field
• Configuration: label, icon, display style

Date

A date range picker with from and to inputs. Filters features by date fields that fall within the selected range.

• Compatible fields: date
• Handler type: field
• Configuration: placeholder text, label, icon, date format

Location

A geocoded location filter. Users search by address or place name, and features are filtered by proximity to the searched location. This is a special filter that does not link to a data field — it uses server-side geocoding.

• Compatible fields: none (special handler)
• Handler type: remote — uses server-side geocoding logic
• Configuration: placeholder text, label, icon, radius settings

Handler types

Each filter uses one of two handler types:

• field — Filters against a data field's values directly. Most filters use this handler.
• remote — Uses special server-side logic. The location filter is the primary example, performing geocoding and proximity calculations on the server.

Adding filters

In the map editor, go to the Filters section. Click Add Filter and configure:

1. Type — Choose a filter type from the list above.
2. Field — Link the filter to a data field (or use a remote handler for special filters like location).
3. Label — The display label shown to users.
4. Icon — An optional icon displayed alongside the filter.

Filter behavior settings

• Auto-submit — When enabled, filters apply immediately as the user changes values. No submit button is needed. This provides a more responsive experience.
• Reset button — When enabled, a button appears that lets users clear all active filters and return to the unfiltered view.

Default values

Filters can have default values pre-applied when the map loads. This is useful for showing a pre-filtered view, such as only displaying locations in a specific category on initial load.

Filter visibility

Filters can be shown or hidden in the UI. Hidden filters still function if they have default values applied, allowing you to create pre-filtered maps without exposing the filter controls.

Translatable strings

Filter labels and placeholder text can be translated for multi-language maps. This ensures your filters display correctly regardless of the visitor's language.

Advanced features

Secondary filters

Available on the Enterprise plan. Secondary filters provide an additional filter group, allowing you to organize filters into primary and secondary tiers for maps with many filtering options.

Remote filtering

Available on the Enterprise plan. With remote filtering enabled, filter processing happens server-side. This is essential for large datasets where client-side filtering would be too slow.