Embedding on your website (incl. WordPress)

How embedding works

Every Sorraia widget installs the same way: you copy one small snippet and paste it into your website's HTML. When someone loads your page, that snippet fetches the widget from Sorraia's servers and displays it. There's nothing to download or install on your server.

You'll find the snippet right after you create or save a widget, in a popup with a Copy Embed Code button. You can also open the Install on your site helper from the widget, which walks you through it. Copy the exact snippet you're shown, it already has your widget's ID and the correct URL baked in.

• The snippet is a short HTML comment, an empty <div>, and a <script src="..."> tag.
• It always points at Sorraia (for example .../api/embed/cal/42.js), so the widget stays up to date automatically.
• Re-saving the widget in Sorraia updates what visitors see, you don't need to re-paste the snippet.

Install it on your verified domain

Each widget is tied to a domain you've added and verified in Sorraia. The embed is meant to run on that domain, so paste the snippet into the site at the verified address, not a different domain or a random test page.

If a widget isn't loading, first check that you pasted it on the domain the widget belongs to and that the domain shows as verified in Sorraia. A widget on an unverified or mismatched domain may refuse to load.

Where to paste it in the page

Where the snippet goes depends on the widget type. A chat panel or a WhatsApp button is a floating launcher, it pins itself to a bottom corner of the screen no matter where the snippet sits, so you can add it once in a site-wide spot and it appears on every page.

A booking calendar or a form is different: it renders in place, exactly where its <div> sits. Paste the whole snippet at the spot on the page where you want the calendar or form to show up.

Adding it in WordPress

In the WordPress block editor, open the page where you want the widget, add a Custom HTML block (search for "Custom HTML" when you add a block) at the right spot, paste the snippet into it, then Update or Publish the page.

If you build pages with Elementor, drop the HTML widget where the widget belongs and paste the snippet there. In Divi, use the Code module on the row you want. For a floating chat or WhatsApp launcher that should appear across the whole site, you can instead paste the snippet once site-wide, for example in your theme's footer area or via a trusted code-snippets plugin. Sorraia doesn't have its own WordPress plugin, any method that lets you add a raw <script> tag works.

Generic HTML sites

On a hand-built or non-WordPress site, open the page's HTML in your editor or CMS and paste the snippet where you want the widget to appear (for a floating launcher, anywhere in the page is fine). Save and re-deploy the page.

The snippet is standard HTML, so the same approach works in Webflow's Embed element, a Squarespace Code Block, a Wix Embed HTML element, or any builder that accepts custom code.

Check that it's live

Use the Install on your site helper to confirm the install. Paste the URL of the page where you added the snippet and click Detect & verify. Sorraia loads that page, tells you which platform it detected, and reports whether it found your embed on the page.

If it says the embed isn't on the page yet, finish pasting and publishing, then click Re-check. Once it shows the embed was found, you're done. You can also just open your live page in a browser and look for the widget.