> 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>Library dependent</sup>
* **Globe** — switches the map projection to a 3D globe view instead of a flat map. <sup>Library dependent</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>Library dependent</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>Library dependent</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).

**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** — 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.

## Specialty

Specialty map types — including heatmaps, side-by-side map comparisons, user submission maps, and listing page maps — 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.

## Loading

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** — 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** — 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.