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.

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.

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:

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

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. For the table setting, see Map settings.

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.

Hiding the Felt logo is part of custom branding. See Workspaces.

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

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.

Embed a map for people without Felt accounts

Available with the Platform add-on. Compare plans

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.

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.

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.

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.