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.
On this page
Prerequisites
Before you start, have the following ready:
- Your Embeddy embed code. Log in at https://embeddy.ai/dashboard, open your widget, and copy the iframe embed code:
<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
Open the site editor
Log in to your Square Dashboard, go to Square Online, then click "Edit Site" to open the website editor.
- 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
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
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>- 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
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
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>- 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