Skip to article

Embedding Guide

Install the current EasyAgentIDX widget container and loader on your website.

Open a widget's Embed tab and copy the complete code. Each widget has its own embed key. The container sets its position on the page and the loader starts the widget.

The embed structure

<div data-eai-widget data-embed-key="YOUR_EMBED_KEY"></div>
<script src="https://app.easyagentidx.com/api/embed/loader" async></script>

Use the actual snippet from your account. Keep its container, key and loader together. Multiple widget containers can share one loader on a page. Widgets render inside an isolated component so you customize their appearance in EAI rather than through your theme's CSS.

WordPress

  1. Edit the published page where you want the widget.
  2. Add a Custom HTML block or your page builder's HTML or code element.
  3. Paste the complete embed snippet and save.
  4. Open the published page to check it. Some editors do not run scripts inside their editing canvas.

If using an EAI shortcode, install and configure the supporting EAI plugin first. A shortcode alone does not load a widget on a site without that integration.

Webflow, Squarespace, Framer and custom HTML

Use a page-level HTML or code embed that allows scripts. Put the widget container at the intended location and include the loader once. Publish the page before testing. A global footer is suitable for loading the script, while visible widget containers belong in the page layout.

Builders with iframe embeds

An iframe can introduce a different origin and a fixed height. Check the builder's custom-code options and confirm the actual published origin matches your approved website. If a widget reports an unauthorized domain, check Sites and Domains before changing the snippet.

If a widget does not appear

  • Confirm the website, MLS feed and subscription are active.
  • Check that the page includes the correct container and loader.
  • Exclude the loader from script delay or combination tools if they prevent initialization.
  • Check your content security policy and browser console for blocked scripts or requests.
  • For maps, configure your Google Maps browser key in Settings > Integrations.