> For the complete documentation index, see [llms.txt](https://help.felt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.felt.com/share/embed-a-map.md).

# Embed a map

Embed an interactive Felt map in a website, Notion, WordPress, or Power BI. Customize the iframe's legend, tools, controls, and view.

To embed a Felt map, open it on a computer, click **Share** > **Embed** > **Copy code**, and paste the iframe code into your site. People can explore the map, click features, and see photos without leaving your page. For a public embed, set public link access to **View** or **View and comment**. See [Set public link access](/share/share-a-map.md#set-public-link-access).

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FSo7PHEJvg3cxpFrkuQxJ%2FBranded%20Embeds.mp4?alt=media&token=cf61d6ea-ebdd-4ea8-a153-923be50802db>" %}

## Embed a map on a website

The **Configure embed** dialog shows a live preview of your Felt map and generates its iframe code.

1. Click **Share** at the top right of the map, then click **Embed**. The **Configure embed** dialog opens.
2. Optional: Under **Settings**, choose what the embed shows. See [Embed settings](#embed-settings).
3. Pan and zoom the preview to set the view people see when the embed opens.
4. Click **Copy code**.
5. Paste the code into your website's HTML where the map should appear.

The copied code looks like this:

```html
<iframe width="100%" height="488" frameborder="0" title="Felt Map" src="https://felt.com/embed/map/Global-Human-Settlement-5FzbIDg4RA9B5XnhuPnGgzC?loc=20.1,5.3,2.5z&legend=1&cooperativeGestures=1&link=1&geolocation=0&zoomControls=1&scaleBar=1&rotation=1&contextMenu=1" referrerpolicy="strict-origin-when-cross-origin"></iframe>
```

The embed URL starts with `https://felt.com/embed/map/`. The regular map link, `https://felt.com/map/…`, can't be shown in an iframe. To change the embed's size, edit `width` and `height`.

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2Fgit-blob-0d77086347311d0f265bce1db8841a27a1ae392e%2Fembed-dialog.webp?alt=media" alt="Configure embed dialog with a live preview of the River Rate Monitor map, the Settings section, and Copy code."><figcaption></figcaption></figure>

## Embed settings

In **Configure embed** > **Settings**, choose what the embed shows and how people interact with it.

| Setting  | What it controls                                                                                                              | Default                       |
| -------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| Top bar  | A bar across the top with your color, logo, and text                                                                          | Off                           |
| Legend   | The legend, with the map title and description. Turn it off to hide the legend.                                               | On                            |
| Tools    | Buttons for Search, Basemap, Table, and Measure. Table requires Viewers can open table to be turned on in the map's settings. | None                          |
| Controls | Open in new tab, Rotation, Right-click menu, Viewer location, Zoom buttons, and Scale bar                                     | All on except Viewer location |
| Zoom     | With modifier key: people hold Cmd (Mac) or Ctrl (Windows) to zoom. On scroll: scrolling zooms the map.                       | With modifier key             |
| View     | The center and zoom the embed opens to, taken from the preview                                                                | The preview's view            |

To let people search for addresses and places in the embed, add Search under **Tools**. See [Search](/tools/search.md). For the table setting, see [Map settings](/maps/map-settings.md).

**Copy code** writes the settings into the iframe's `src` as URL parameters, such as `legend=0` to hide the legend and `loc=40.71,-74.01,12z` for the view. To rotate the view when the embed opens, add a bearing to `loc`, such as `40.71,-74.01,12z,45b`. Embed URLs have no parameters for filters, layer visibility, or selected features. To control those from your page, use the [JavaScript SDK](/developers/javascript-sdk.md).

Hiding the Felt logo is part of custom branding. See [Workspaces](/administration/workspaces.md).

## Embed in Notion, WordPress, and other tools

Notion, WordPress, and other tools that support oEmbed can embed a Felt map from its link. oEmbed is a standard that turns a pasted link into an interactive embed.

1. In the map, click **Share** at the top right, then click **Copy link**.
2. Paste the link into your Notion page or WordPress post. The interactive map appears.

For a site builder without oEmbed, paste the iframe code from **Copy code** into an HTML or custom code block. See [Embed a map on a website](#embed-a-map-on-a-website).

## Embed in Power BI

In Power BI, the HTML Content visual displays a Felt map in your report by rendering iframe code stored in your data.

1. In Felt, copy the map's iframe code with **Copy code**. See [Embed a map on a website](#embed-a-map-on-a-website).
2. In Power BI, add the code as the value of a column in your data.
3. In the **Visualizations** pane, click **Get more visuals** and add the **HTML Content** visual to your report.
4. Select the column that holds the iframe code. The map appears in the visual.

## Embed a map only invited people can open

A Felt embed can be limited to people you invite. Leave the map's public link access at **None** and invite each person to the map. They log in to Felt to see the embed, and everyone else sees *Map Not Found*. See [Invite people by email](/share/share-a-map.md#invite-people-by-email).

## Embed a map for people without Felt accounts

{% hint style="success" %}
Available with the Platform add-on. [Compare plans](https://felt.com/pricing#compare)
{% endhint %}

An authenticated embed lets your customers open a private map without a Felt account and without joining your workspace. Your application gets an embed token from the Felt REST API and adds it to the embed URL. Each token uses the viewer's email address for tracking. See [Authenticated embeds](/developers/authenticated-embeds.md).

## Troubleshooting embeds

### Embed shows "Map Not Found"

The person viewing the embed doesn't have access to the map, most often because public link access is **None**. To show the map to everyone, set public link access to **View** or **View and comment** with the **Public access** selector in the map's **Share** menu. The error page mentions *Share to web*, the old name for public link access.

### Embed shows "Upgrade to embed maps"

The map's workspace plan doesn't include embeds. To embed maps, upgrade the workspace. See [Free plan](/plans-and-billing/free-plan.md).

### Embed shows "Map view limit reached"

The workspace has used all its map views for the month. Each load of an embed counts as one map view. The embed works again when the limit resets on the first day of the month. See [Plan usage](/plans-and-billing/plan-usage.md).

### Browser says felt.com refused to connect

The iframe uses the regular map link (`https://felt.com/map/…`) instead of the embed URL. Copy the code again with **Copy code**, or change `/map/` to `/embed/map/` in the iframe's `src`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.felt.com/share/embed-a-map.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.