---
title: Map element
slug: map
description: How the Map element works in Personizely widgets: embedding a Google Maps place, the exact URL format it needs, why short links fail, title and sizing options.
image: https://archbee-image-uploads.s3.amazonaws.com/1y1Fr-DMGy_apx7FwibyA/ORDTWfNKMXiY3ZRv0QSgP_personizely-docs-og.png
docTags: 
createdAt: 2026-10-16T20:17:13.783Z
---

The Map element embeds an interactive Google Map of a place in a widget, such as your store's location in a "Visit us" popup. It's display-only: it has no action or automations.

**Available on:** all platforms.

## URL format

The **Maps URL** must be a Google Maps **place** URL that contains `/maps/place/<name>/`, with the slash after the name. For example:

```text
https://www.google.com/maps/place/East+Palo+Alto,+CA/
```

To get one, search for the place on Google Maps in a desktop browser and copy the address bar URL. Any URL without `/maps/place/…/` shows nothing. That includes short share links (`maps.app.goo.gl/…`), embed codes and directions links.

## Options

| Option            | What it does                                                                                   | Values / default |
| ----------------- | ---------------------------------------------------------------------------------------------- | ---------------- |
| **Maps URL**      | The place to show                                                                              | A sample place   |
| **Title**         | Accessible name of the map for screen readers                                                  | Empty            |
| Style             | Border, radius, shadow, opacity, size, margin, position; hover and focus states                | Full width, 16:9 |
| Device, Animation | See [Widget elements](https://docs.personizely.net/widget-elements#settings-every-element-has) | —                |

## Behavior details and limitations

- **Google Maps only.** Other map providers aren't supported.
- **No API key needed.** The map is embedded through Google's Maps embed; you don't need your own Google key.
- **Only the place is used.** Zoom level, layers or a route in the URL are ignored; the map centers on the place.
- **Maps are heavy on mobile.** Consider **Show on: Desktop** and a text address with a link for phones.

## Example

A callout on the contact page: a headline "Visit our flagship store", the map of the store, and a [button](https://docs.personizely.net/button) **Open URL** to the Google Maps directions link in a new tab.

## Related

- [Video](https://docs.personizely.net/video)
- [Image](https://docs.personizely.net/image)
- [Widget elements](https://docs.personizely.net/widget-elements)