> For the complete documentation index, see [llms.txt](https://wpmaps-docs.mapster.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wpmaps-docs.mapster.me/mapster-wp-maps-v2/the-mapmaker/styling.md).

# Styling

Each feature's appearance is configured in the right panel when that feature is selected. The options available depend on the feature type. Hover over any feature in the left panel list and click it to open its settings.

> **Looking to add or manage features?** See [Features](/mapster-wp-maps-v2/the-mapmaker/features.md).

## Markers

Markers are the classic map pin. Select a marker to access:

**Appearance**

* **Color** — the fill color of the marker
* **Size** — scales the marker up or down as a percentage of its default size

**Marker Styling**

* **Anchor** — which point of the marker image aligns to the coordinate. Defaults to bottom-center (the pin tip). Options: Center, Top, Bottom, Left, Right, and the four corners.
* **Rotation** — rotates the marker 0–360°

**Interactivity — Hover Effects** <sup>Library dependent</sup>

* When enabled, set a separate **Hover Color**, **Hover Size**, and **Hover Rotation** that activates when a user's cursor is over the marker.

## Circles

Circles are filled, fixed-radius points — useful for representing areas or for a cleaner look than a pin.

**Appearance**

* **Color** — fill color
* **Radius** — size in pixels
* **Opacity** — fill transparency (0–100%)

**Circle Styling**

* **Border Color**, **Border Width**, **Border Opacity** — stroke around the circle
* **Static size during zoom** — when enabled, the circle stays the same pixel size regardless of zoom level, rather than scaling with the map <sup>Library dependent</sup>

**Interactivity — Hover Effects** <sup>Library dependent</sup>

* Set a **Hover Color**, **Hover Radius**, **Hover Opacity**, and separate **Hover Border** color, width, and opacity.

## Labels & Icons

The Label & Icon type (called Symbol internally) lets you display a custom image and/or a text label directly on the map at a coordinate, without a pin shape.

**Icon**

* **Icon Enabled** — toggle the icon on or off independently of the text label
* **Image** — select from your media library
* **Size** — scale as a percentage

**Icon Style** (visible when icon is enabled)

* **Anchor** — alignment point of the icon to its coordinate (same options as Marker)
* **Opacity**, **Rotation** — standard
* **Move X / Move Y** — offset the icon from its exact coordinate in either direction
* **Static size during zoom** <sup>Library dependent</sup>

**Text**

* **Text Enabled** — toggle the text label on or off
* **Label Text** — the text to display (can be a fixed string)
* **Text Color**, **Text Size**

**Text Style** (visible when text is enabled)

* **Font** — choose from a set of available typefaces (Open Sans, Klokantech Noto Sans, Metropolis in Regular, Bold, and Italic variants)
* **Opacity**, **Rotation**
* **Move X / Move Y** — offset the label from its coordinate
* **Outline Color**, **Outline Width**, **Outline Blur** — adds a halo around the text for legibility

**Interactivity — Hover Effects** <sup>Library dependent</sup>

* When icon is enabled: set a **Hover Icon Opacity**.

## Lines

**Appearance**

* **Color** — stroke color
* **Width** — stroke width in pixels
* **Opacity** — transparency (0–100%)

**Line Styling**

* **Dashed Line** — when enabled, set a **Dash Length** and **Gap Length** in pixels to create a dashed or dotted stroke

**Interactivity — Hover Effects** <sup>Library dependent</sup>

* Set a **Hover Color**, **Hover Width**, and **Hover Opacity**.

## Polygons (Flat)

**Appearance**

* **Color** — fill color
* **Opacity** — fill transparency (0–100%)

**Polygon Styling**

* **Outline Color** — stroke color around the polygon boundary

**Interactivity — Hover Effects** <sup>Library dependent</sup>

* Set a **Hover Color**, **Hover Opacity**, and **Hover Outline Color**.

## Polygons (3D)

3D polygons are extruded shapes, like building footprints raised off the map surface. <sup>Library dependent</sup>

**Appearance**

* **Color** — fill color
* **Base Height** — the height at which the extrusion starts (for floating shapes)
* **Top Height** — the total height of the extrusion

**Interactivity — Hover Effects**

* Set a separate **Hover Color**, **Base Height**, and **Top Height** on hover.

## Image Polygons

Fill a polygon with an image instead of a solid color.

**Appearance**

* **Image** — select an image from your media library to use as the fill

## Clustering

Clustering groups nearby point features into a single bubble when zoomed out, reducing visual clutter. Access clustering settings by clicking **Manage Clustering** in the left panel.

**Enable Clustering** — turns clustering on or off for the map.

**Cluster Types** — choose which feature types participate in clustering. Any combination of Markers, Circles, Labels & Icons, Polygons, and Lines can be clustered.

**Image** — optionally replace the default circle clusters with a custom image from your media library.

### Behavior

* **Cluster by Category** — when enabled, each Mapster category gets its own cluster, so features from different categories stay separate even when overlapping. Set the **Included Categories** to control which categories participate.
* **Show Category Name** — displays the category name on the cluster bubble.

### Colors

When not clustering by category, set colors independently for **Small**, **Medium**, and **Large** cluster sizes. Each size has:

* **Cluster Color** — the bubble fill
* **Border Color** — the ring around the bubble
* **Font Color** — the count number

When clustering by category, you can enable **Category Colors** to assign a distinct color to each category's clusters. When category colors are active, the size-based color settings above don't apply.

### Sizes

Set **Radius** and **Border Width** independently for Small, Medium, and Large clusters. Size options are not available when clustering by category.
