> For the complete documentation index, see [llms.txt](https://docs.mapsindoors.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mapsindoors.com/cms/core-concepts/display-rules/configuring-display-rules.md).
# Configuring Display Rules
***
This page covers every setting in the Display Rule editor. If you are not yet familiar with what Display Rules are or how inheritance works, start with [Display Rules](https://docs.mapsindoors.com/products/cms/display-rules) first.
The editor is divided into sections. Each section controls a different visual element and can be toggled and configured independently.
***
### General
The General section controls the top-level visibility of the Location on the map. If this is turned off, no other Display Rule settings apply — the Location will not appear at all.
**Visibility** — whether the Location is visible on the map.
***
### Icon
The Icon section controls the map marker image shown for the Location.
**Visibility** — whether the icon is shown on the map.
**Zoom from / Zoom to** — the zoom level range within which the icon is visible. Values run from 1 (very far out) to 999 (max zoom). The recommended setting for Zoom to is to check the **Max zoom** checkbox, which sets the value to 999.
**Icon** — the image used as the map marker. In the CMS, click the Icon field to open the Media Library, where you can choose from a pre-loaded set of icons or upload your own.
Map provider zoom level limits
Google Maps supports a maximum zoom level of 22.
Mapbox supports up to 25.
Setting a Zoom from or Zoom to value above the supported maximum for your map provider will result in the icon not appearing at those levels.
***
### Label
The Label section controls the text shown near the Location's marker on the map.
{% hint style="info" %}
**Note:** Labels are only visible in the CMS when a Location is being actively edited. In the default map view, labels are not shown.
{% endhint %}
**Visibility** — whether the label is shown on the map.
**Zoom from / Zoom to** — the zoom level range within which the label is visible. The recommended setting for Zoom to is to check the **Max zoom** checkbox.
**Template** — controls what text the label displays. Options are:
* Location Name
* External ID
* External ID & Location Name (External ID first)
* Location Name & External ID (Location Name first)
**Max width** — how wide the label can be before the text wraps to a new line. A value of `0` disables line-breaking entirely.
Max width units differ by map provider
On Google Maps, Max width is measured in pixels.
On Mapbox, it is measured in EM units (relative to font size — at the default size of 16px, 1 EM ≈ 1 character width).
***
### Label Style
The Label Style section controls the visual appearance of the label text. **This section is only supported on Mapbox — it has no effect on Google Maps.**
**Label Type** — controls the type of label rendered. Options are:
* **Text Label** (default) — a floating text label positioned relative to the icon
* **Flat Label** — text rendered flat on the map surface, rotatable with a bearing value
* **Graphic Label** — text with a custom background image
**Text Size** — the size of the label text, from 1 to 255.
**Text Color** — the color of the label text. Use the color picker in the CMS or provide a 6-digit HEX code (e.g. `#3071D9`) when setting in-app.
**Text Opacity** — opacity of the text, from `0` (fully transparent) to `1` (fully opaque).
**Halo Color** — the color of the halo surrounding the text.
**Halo Width** — the thickness of the halo in pixels.
**Halo Blur** — how far into the halo width the blur effect starts. For example, with Halo Width = 10px and Halo Blur = 5px, blurring begins at the midpoint of the halo.
#### Sub-sections by Label Type
Text Label → Label Position
Controls where the floating label appears relative to the Location's anchor point. Options are: top, bottom, left, right.
Text Label → Label Position Flat Label → Bearing
Controls the rotation of the flat label on the map surface, measured in degrees like a compass bearing (0–360).
Graphic Label → Add Graphic Label
Opens the Media Library, pre-filtered for graphic label background images. Select or upload the background image to use behind the label text.
***
### Polygon
The Polygon section controls the filled overlay drawn on top of Rooms and Areas. Polygons are independent from the map tiles underneath — they are an additional overlay layer, so opacity settings affect how the tile appears through the polygon.
> **Note:** It is not possible to override the appearance of the base map tiles themselves.
**Visibility** — whether the polygon is shown on the map.
**Zoom from / Zoom to** — the zoom level range within which the polygon is visible.
**Stroke color** — the color of the polygon border. Use the color picker in the CMS or provide a 6-digit HEX code when setting in-app.
**Stroke width** — the width of the polygon border in pixels.
**Stroke opacity** — the opacity of the border, from `0` to `1`.
**Fill color** — the interior color of the polygon.
**Fill opacity** — the opacity of the interior, from `0` to `1`.
***
### 2D Model
{% hint style="info" %}
This feature must be enabled for your Solution by MapsPeople before it is available. Contact your MapsPeople representative to have it enabled.
{% endhint %}
2D Models are images placed on the map surface at a fixed real-world size. Unlike icons, they scale with zoom level — making them well suited for exhibitor logos, store branding, or any image that should occupy a defined area on the map.
**Visibility** — whether the 2D model is shown on the map.
**Zoom from / Zoom to** — the zoom level range within which the 2D model is visible.
**2D Model** — opens the Media Library to select or upload the image to display.
**Width × Height** — the real-world dimensions of the model in meters. Width and height are locked to the original aspect ratio and cannot be changed independently. Use the **Fit to Location** option to automatically size the model to fill the Location's polygon as much as possible, based on the anchor point position.
**Bearing** — the rotation of the 2D model on the map, measured in degrees like a compass bearing (0–360).
***
### 3D Walls
The 3D Walls section controls the extruded walls shown around a Location in 3D view. This applies to Rooms and Areas. For requirements and setup, see [3D Maps](https://docs.mapsindoors.com/3d-maps).
**Visibility** — whether the 3D walls are shown on the map.
**Zoom from / Zoom to** — the zoom level range within which the walls are visible. Mapbox supports up to zoom level 25. Values above the supported maximum will result in walls not appearing.
**Wall color** — the color of the walls. Use the color picker in the CMS or provide a 6-digit HEX code when setting in-app.
**Wall height** — the height of the walls in meters.
***
### 3D Extrusions
The 3D Extrusions section controls per-room height extrusions in 3D view — useful for visually highlighting specific rooms such as an important meeting room or a featured space. For requirements and setup, see [3D Maps](https://docs.mapsindoors.com/3d-maps).
**Visibility** — whether the extrusion is shown on the map.
**Zoom from / Zoom to** — the zoom level range within which the extrusion is visible.
**Extrusion color** — the color of the extruded room. Use the color picker in the CMS or provide a 6-digit HEX code when setting in-app.
**Extrusion height** — the height of the extrusion in meters.
***
### 3D Model
The 3D Model section places a GLB 3D model at the Location's anchor point on the map. Models are uploaded via the Media Library. For requirements and setup, see [3D Maps](https://docs.mapsindoors.com/3d-maps).
**Visibility** — whether the 3D model is shown on the map.
**Zoom from / Zoom to** — the zoom level range within which the 3D model is visible. Mapbox supports up to zoom level 25.
**3D Model** — opens the Media Library to upload and select the GLB model to display.
**X-axis rotation** — rotation of the model around the X-axis, in degrees (0–360).
**Y-axis rotation** — rotation of the model around the Y-axis, in degrees (0–360).
**Z-axis rotation** — rotation of the model around the Z-axis, in degrees (0–360).
**Scale** — a multiplier applied to the model's original size. Use this to make the model larger or smaller relative to its uploaded dimensions.
