Embedding

Embed interactive maps in websites with customizable display options.

This feature is only available on the Enterprise plan. Contact sales to upgrade.

Embed an interactive Felt map within your organization’s website, blog, or Notion page. Viewers will be able to pan, scroll and toggle Data Layers.

• To embed your map on a website, navigate to File > Embed in the Felt menu (upper-left corner) or the Share menu (upper-right corner).

• Add your company logo/name, customize the color bar, and choose which parts of the UI to show/hide, like the Legend.

• If components like Measure and Search are added to your map, they will also appear in the embed for viewers to interact with.

• Adjust the size using preset sizes or set a custom size.

• Move the map to the right spot, then copy the HTML iframe block to embed that view on your site.

Embedding in Notion or WordPress?

Instead of following these steps, simply copy the map link as seen in Sharing a map. This is possible thanks to Felt's oEmbed API. See Integrations to learn more.

Configuring embeds

There are two ways to share an embed:

• Embed: add an <iframe> snippet on your website to include the map with other items on the page. This section will provide you with a code snippet to copy and paste onto your website.

• Web page: share your branded embed map as a full web page. This section will provide you with a Felt URL to share.

Toggle between Embed and Web page sections to share your embed as desired.

Adding a top bar

Toggling Top bar on allows you to configure a custom color, logo, and text to the top of the Felt embed map. You can configure:

• Bar color: set a color to match your brand (pro tip: use our color picker tool)

• Bar logo: upload a logo icon to place in the top-left corner of the bar

• Bar text: set a top-level title for the embed

The map title will remain on the map at the top of the legend, and the legend will be a collapsable list.

Controls & settings

For <iframe> Embed types, you can include or exclude the following map items:

• Interactive map legend

• Full screen map link

• Viewer location tool

• Zoom (- / +) buttons

• Scale bar

Default Zoom behavior to hook into On scroll behaviors on the website or requiring a modifier key ("Hold cmd while scrolling to zoom the map").

Default requires a modifier key.

View represents the default viewport. These are the center coordinates and the zoom level at load or refresh.

Panning and zooming in the embed preview will change these parameters.

Authenticated embeds

Although Felt's default embeds require public link access we support authenticated embeds for map links that cannot be public. We offer two options to provide secure access to your private embedded maps in your organization’s website, blog, or Notion page.

Access to embedded Felt maps can be gated in two ways:

1. Token-based authentication

2. User-based authentication

Token-based authentication

Map access is limited by a single-use authentication token generated by Felt’s REST API. Authenticate the embed view by including the token as a query parameter in the map URL.

Token-authenticated users can view the embedded map without signing in. If the token is generated with an associated user email address, those users can also export data from the map.

See the developer documentation for implementation details.

User-based authentication

Map access is limited to signed-in Felt users who have been explicitly invited to the map. Embedded views honor the same sharing permissions as the main map.

To configure user-based authentication:

1. Click the Share button in the upper-right corner of your map

2. Set Public access to None

3. Invite specific users by email (must match their Felt account email)

Frequently asked questions

What is map embedding?

Map embedding allows you to display a live, interactive Felt map within your organization's website, blog, or Notion page. Viewers can pan, scroll, and interact with the map without leaving your site.

What plan do I need to embed a Felt map on my website?

This feature is only available on the Enterprise plan. Contact sales to upgrade.

What can I customize in my embedded map?

You can:

• Add your company logo/name

• Customize the color bar

• Show/hide UI components, such as the Legend

• Adjust size using preset or custom dimensions

• Position the map view before embedding

What interactive features are available in embeds?

If dashboards and extensions like Bar charts, Measure, and Search are added to your map, they will also appear in the embed for viewers to interact with.

How can I share my embed?

There are two available options:

• Embed: Add an <iframe> snippet to include the map alongside other content on your page

• Web page: Share your branded embed as a standalone full web page using a Felt U

How can I control who can access my embedded map?

You can secure embedded maps using two authentication methods:

1. Token-based authentication

• Access is limited by single-use authentication tokens generated via Felt's REST API

• Users can view without signing in

• If the token includes a user email, those users can also export data

• See developer documentation for implementation details

2. User-based authentication

• Access is limited to signed-in Felt users explicitly invited to the map

• Embedded views honor the same sharing permissions as the main map

• To configure: Set Public access to "None" in the Share menu and invite specific users by email (must match their Felt account email)

What view settings can I configure?

The View setting represents the default viewport - the center coordinates and zoom level when the map loads or refreshes. Pan and zoom in the embed preview to adjust these parameters.

What is the default zoom behavior?

By default, zooming requires a modifier key (like holding cmd while scrolling). You can change this to hook into standard On Scroll behaviors on your website.