# 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.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mapsindoors.com/cms/core-concepts/display-rules/configuring-display-rules.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.