> 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/map-settings.md).

# Map Settings

Map Settings live in the **settings drawer** — open it by clicking the palette icon in the right panel welcome screen, or the settings icon in the top bar. Settings are organized into collapsible sections.

> **Note:** Changes in the **Starting View** and **Layout** sections are not reflected in the Mapmaker preview — they only take effect on your live embedded map.

<figure><img src="/files/MTLbNQRgxF52nhK80kIO" alt=""><figcaption></figcaption></figure>

## Style & Base Map

Choose the visual style of your map's background tiles.

Click **Choose Map Style in Map Gallery** to browse and preview available styles. The gallery shows styles from MapLibre, Mapbox, and community providers depending on which library your map uses.

Additional options in this section:

* **3D Terrain** — renders elevation data as a three-dimensional surface. <sup>Pro, Mapbox only</sup>
* **Globe** — switches the map projection to a 3D globe view instead of a flat map. <sup>Pro, Mapbox/MapLibre only</sup>
* **Duplicate map horizontally** — tiles the map continuously left and right so users can pan without hitting the edge of the world. Only available when Globe is disabled. <sup>Mapbox/MapLibre only</sup>
* **Projection** — changes the flat map projection. Options include Mercator, Natural Earth, Albers, Equal Earth, Equirectangular, Lambert Conformal Conic, and Winkel Tripel. Only available when Globe is disabled. <sup>Mapbox only</sup>

## Starting View

Controls where the map is centered and how zoomed in it is when it first loads.

**Initial Load** sets the behavior on load:

* **Fit to Features** — automatically zooms and pans to fit all features on the map. Use the **Padding** slider to add breathing room around the edges.
* **Manual Center & Zoom** — set a fixed center point and zoom level. Enter a latitude and longitude directly, or click **Set from current map view** to use wherever you've panned the preview.
* **User Location** — centers the map on the visitor's current location (requires browser permission). Set a **Zoom** level for how close in the map starts.

**Pitch** and **Rotation** apply regardless of the Initial Load mode and set the map's tilt angle and compass bearing on load.

## Layout

Controls the size of the embedded map.

* **Width** — set a value and unit (%, px, or vw). Defaults to 100%.
* **Height** — set a value and unit (px, %, or vh). Defaults to 400px.

**Full Page Map** expands the map to fill the entire browser viewport. When enabled:

* **Ignore Container** — breaks the map out of its WordPress page container so it spans edge to edge.
* **Hide other page content** — hides everything else on the page, showing only the map.

**Enable Mobile Sizes** lets you set two breakpoints, each with their own width and height. This is useful if your map needs different proportions on smaller screens.

## Interactivity

* **Disable all interaction** — makes the map completely static. Users can't pan, zoom, or click anything.
* **Enable zoom on scroll** — allows zooming with the mouse wheel or trackpad scroll.
* **Enable rotation and pitch** — allows users to tilt and rotate the map by right-clicking and dragging (or two-finger gesture on touch). <sup>Mapbox/MapLibre only</sup>

**Show popups in sidebar** — instead of opening popups over the map, displays them in a sidebar panel. Set a **Minimum Width** and **Maximum Width** for the sidebar.

**Restrict User Movement** <sup>Pro</sup> — prevents users from panning outside a defined bounding box. Enter the northeast and southwest corner coordinates, and optionally set minimum and maximum allowed zoom levels.

## Attribution & Logo

* **Map Attribution** — shows the required copyright text for your map's data/style. You can reposition it but can't remove it without a Mapbox enterprise agreement.
* **Logo** — shows the Mapbox or MapLibre logo. <sup>Mapbox, MapLibre</sup>

Both have a **Position** option once enabled, with the same four corner placements used throughout the [Controls](/mapster-wp-maps-v2/the-mapmaker/controls.md).

## Specialty

Specialty map types — including [heatmaps](https://github.com/mapstertech/mapster-wp-maps-docs/tree/main/v1/maps/specialty-maps/heatmaps.md), [side-by-side map comparisons](https://github.com/mapstertech/mapster-wp-maps-docs/tree/main/v1/maps/specialty-maps/map-comparer.md), [user submission maps](https://github.com/mapstertech/mapster-wp-maps-docs/tree/main/v1/maps/specialty-maps/user-submission.md), and [listing page maps](https://github.com/mapstertech/mapster-wp-maps-docs/tree/main/v1/maps/specialty-maps/listing-page-map.md) — are not yet available in the Mapmaker interface. To configure them, open your map in the **Classic Editor** (linked in the top bar or in this section) and go to the **Specialty Maps** tab.

> **Looking for elevation profiles?** That's no longer a specialty map type — it's the [Elevation](/mapster-wp-maps-v2/the-mapmaker/controls.md#elevation) control, available directly in the Mapmaker.

## Loading <sup>Pro</sup>

Customize the loading screen that appears while the map initializes.

* **Use custom loader** — when disabled, choose from a set of built-in loading graphics and set a **Background Color** and **Loader Color**. When enabled, upload your own image to use instead.

## Developer

* **Allow map embed** <sup>Pro</sup> — enables your map to be embedded via `<iframe>` on external sites. Add one or more **Allowed Origins** (e.g. `https://example.com`) to control which domains can embed it. The iframe code is shown here once enabled.
* **Use Cache** <sup>Pro</sup> — generates a static JSON cache file for your map data, which can improve frontend load times. After saving any changes, click **Generate Cache** to rebuild it. Cache is not used inside the Mapmaker preview.
* **Custom JS Function** — enter the name of a JavaScript function defined elsewhere on your site. This function will be called after the map initializes, with the map instance passed as an argument. See the [Developer](/mapster-wp-maps-v2/developer/sdk-overview.md) section for more on working with the map instance programmatically.