Add the Paloma Widget to Your Squarespace Site

Your Paloma widget lets guests start an event inquiry right from your website. There are two ways to add it to Squarespace, and the right one depends on your Squarespace plan. Both take a few minutes.

For more background and the full installation instructions, see the Website Integration Guide for the Paloma Widget.

First, find your widget link

In your Paloma dashboard, open Settings, then click your venue and go to Links and Installation. In the Adding your Widget to your Website section you will see:

• Your widget link, which looks like https://widget.app.palomaparties.com/events/YOUR_WIDGET_ID
• Your widget ID, the part after /events/

Paste it here and all the code snippets on this page will update with your ID:

Which path is right for you?

Code Injection, which the embed option needs, is only available on Squarespace Core plans and above. If you are on Personal or Basic, use Option A. You can always upgrade later and switch to Option B.

Option A: Link a button to your widget (works on any plan)

This is the quickest path and works on every Squarespace plan.

1. Add or edit a button on your page (for example “Plan Your Event” or “Book an Event”).
2. For the button link, choose the external URL option and paste your widget link: https://widget.app.palomaparties.com/events/YOUR_WIDGET_ID
3. Save.

When a guest clicks the button, your Paloma inquiry page opens and they can start their request. That is everything you need to start collecting inquiries.

Option B: Embed the widget on your pages (Core plan or higher)

With this option the widget opens as an overlay on your own site, so guests stay on your page the whole time.

Step 1: Add the widget snippet

1. Go to Settings, then Advanced, then Code Injection.
2. Paste this into the Footer box. If you entered your widget ID above, it is already filled in. Otherwise, replace YOUR_WIDGET_ID with your widget ID.

<script>
  (function (window, document) {
    if (window.palcon) {
      console.error("palcon embed already included");
      return;
    }
    window.palcon = { _c: [] };
    ["init"].forEach(
      (me) =>
        (window.palcon[me] = function () {
          window.palcon._c.push([me, arguments]);
        }),
    );
    var elt = document.createElement("script");
    elt.type = "module";
    elt.async = true;
    elt.src = "https://widget.app.palomaparties.com/shim.js";
    var before = document.getElementsByTagName("script")[0];
    before.parentNode.insertBefore(elt, before);
  })(window, document);
  palcon.init("YOUR_WIDGET_ID");
</script>

<script>
  document.addEventListener(
    "click",
    function (e) {
      var a =
        e.target.closest && e.target.closest('a[href*="eventsWidget=show"]');
      if (!a) return;
      if (window.palcon && document.getElementById("palcon-iframe")) {
        e.preventDefault();
        window.dispatchEvent(new Event("palconToggleEvent"));
      }
    },
    false,
  );
</script>

The Footer box adds this to every page, so you only do it once. If you would rather add it to a single page, use that page’s Settings, then Advanced, then Page Header / Footer Code Injection instead.

The first part loads the widget. The second part is what makes your buttons open the widget in place, without reloading the page, so guests keep their spot. We recommend keeping both. If you ever paste only the first part, buttons will still work, they will just reload the page each time.

Step 2: Add a button that opens the widget

The snippet loads the widget, but you still need something for guests to click. Pick whichever fits how you build pages:

A regular Squarespace button. Squarespace buttons can only hold a link, so point the button at any page on your site with ?eventsWidget=show added to the end:

https://www.yoursite.com/your-page?eventsWidget=show

With the snippet from Step 1 in place, the widget opens right there with no reload. (If you skipped the second part of the snippet, the page reloads and then opens the widget.)

A Code Block button. If you build with Code Blocks, add one where you want the button and use this:

<a href="javascript:void(0);" class="palconTrigger">Plan Your Event</a>

The palconTrigger class tells the widget to open. You can style it to match your other buttons.

Where to place your buttons

Put a button anywhere a guest might decide to host an event. The most useful spots are:

• Your homepage, near the top
• Any private events, group bookings, or celebrations page
• Your contact page
• Your menu page, for guests planning a group meal

A good rule: if a page mentions events, give it a button.

If the widget does not open

• Nothing happens when you click. Confirm you replaced YOUR_WIDGET_ID with your real widget ID, and that the button link or class matches the steps above.
• The widget never loads. Open your browser’s developer console and look for the widget snippet loading. Some setups strip parts of an injected script. If you see an error, paste the snippet again exactly as shown and save.
• You cannot find Code Injection. Your plan may not include it. Use Option A instead, or upgrade to a Core plan.