How to Embed a Widget on Square Online

Square Online lets you build a free online store connected to your Square POS system. By embedding Embeddy widgets, you can add interactive calculators, product configurators, quizzes, and lead forms to your store. This guide covers two methods: the Embed Code section in the site editor and global Code Injection for site-wide scripts.

Beginner~6 min readUpdated 2026

Prerequisites

Before you start, have the following ready:

<iframe
  src="https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID"
  width="100%"
  height="500"
  frameborder="0"
></iframe>
  • Square Online account. You need access to the Square Online site editor. The Embed Code section is available on the Free plan. Code Injection (Method 2) requires a Plus plan or higher.

Tip: Square Online's site editor autosaves your work, but changes are not live until you click "Publish". You can safely experiment with the embed code before making it public.

Method 1: Embed Code Section

Easiest — no code knowledge needed

Square Online includes a built-in Embed Code section type that you can add to any page. This renders external HTML including iframes, making it the simplest way to add an Embeddy widget.

  1. 1

    Open the site editor

    Log in to your Square Dashboard, go to Square Online, then click "Edit Site" to open the website editor.

  2. 2

    Navigate to the target page

    Use the page navigator in the editor to go to the page where you want the widget (e.g., Home, a custom page, or a landing page).

  3. 3

    Add an Embed Code section

    Click "Add Section" (the + icon between sections). Browse or search for "Embed Code" and select it. A new section will appear on your page.

  4. 4

    Paste your embed code

    Click on the embed section to open its settings. Paste your Embeddy iframe embed code into the "Code" field.

<div style="max-width: 800px; margin: 2rem auto; padding: 0 1rem;">
  <iframe
    src="https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID"
    width="100%"
    height="500"
    frameborder="0"
    style="border: none; border-radius: 8px;"
    loading="lazy"
    title="Interactive Widget"
  ></iframe>
</div>
  1. 5

    Publish

    Click "Publish" in the top-right corner. Visit your live site to confirm the widget appears.

Tip: You can drag the Embed Code section to reposition it among other sections on the page. The embed code will render in the editor preview so you can see the widget as you design your page.

Method 2: Code Injection (Site-Wide)

Plus plan — adds code to all pages

For widgets that should appear on every page (e.g., a floating helper widget), Square Online's Code Injection feature lets you add HTML/JS to the header or footer of every page on your site.

  1. 1

    Open Code Injection settings

    In your Square Dashboard, go to Square Online > Website > Settings, then select "Tracking and Code Injection" (or "Code Injection" under Advanced).

  2. 2

    Add your script to the footer

    In the Footer Code section, paste a script that creates your Embeddy iframe and appends it to the page:

<script>
  document.addEventListener("DOMContentLoaded", function() {
    var container = document.querySelector("main, .content, body");
    if (container) {
      var wrapper = document.createElement("div");
      wrapper.style.maxWidth = "800px";
      wrapper.style.margin = "2rem auto";
      wrapper.style.padding = "0 1rem";
      wrapper.innerHTML = '<iframe src="https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID" width="100%" height="500" frameborder="0" style="border:none;border-radius:8px;" loading="lazy" title="Interactive Widget"></iframe>';
      container.appendChild(wrapper);
    }
  });
</script>
  1. 3

    Save

    Click "Save". The code will be injected on all pages of your Square Online site.

Note: Code Injection is available on the Square Online Plus plan and higher. For the Free plan, use Method 1 (Embed Code section) on individual pages.

Troubleshooting

The Embed Code section shows "Unable to load content"

This usually means the HTML is malformed. Double-check that all tags are properly closed and that the iframe src URL is correct. Copy the embed code fresh from the Embeddy dashboard.

The widget shows a blank area

Verify your Widget ID and Props ID are correct and that the widget is published (not in draft). Check the browser console (F12) for any errors.

I do not see the Code Injection option

Code Injection requires a Square Online Plus plan or higher. If you are on the Free plan, use Method 1 (Embed Code section) instead — it is available on all plans.

Widget is cut off on mobile

Ensure the iframe has width="100%" and the wrapper div includes padding: 0 1rem; to add side margins on narrow screens.

Frequently Asked Questions

Will an embedded widget slow down my Square Online store?

No. Iframes load independently and do not block your page. Using loading="lazy" ensures the widget loads only when scrolled into view.

Can I embed a widget on product pages?

Square Online product pages have a fixed layout with limited customization. The Embed Code section works best on custom pages and landing pages. For product pages, use Code Injection (Method 2) with JavaScript that targets the product page DOM.

Does this work on the Square Online Free plan?

Yes — the Embed Code section (Method 1) is available on all Square Online plans including Free. Code Injection (Method 2) requires Plus or higher.

Ready to supercharge your Square Online store?

Build a free interactive widget — calculator, product configurator, quiz, or anything you need — and embed it on your store in minutes.

Create your free widget at embeddy.ai