Skip to main content

Putting Linwick on a website

One <script> tag. It adds a button in the corner of the site that opens the cleaning company’s enquiry assistant. No build step, no package, no framework, and nothing runs until a visitor clicks.

If you are the web developer and this was forwarded to you with no explanation: Linwick is an enquiry assistant your client subscribes to. This page is the whole integration.

01

Paste the tag before </body>

Replace your-slug with the slug from your setup confirmation email — it is the last part of your enquiry page address.

<script src="https://www.linwick.co.uk/embed.js" data-linwick="your-slug" defer></script>

It works anywhere a script tag works: a hand-written HTML file, WordPress (Appearance → Theme File Editor, or any “custom HTML / footer scripts” plugin), Squarespace (Settings → Advanced → Code Injection → Footer), Shopify (theme.liquid, before the closing body tag), Wix (Settings → Custom Code → Body end), or Google Tag Manager as a Custom HTML tag.

Put it on every page, or only the pages where an enquiry makes sense. Both are fine. Two copies on the same page are not needed — the script notices and only mounts once.

02

Check it worked

Load the page. A button reading Get a quote appears in the bottom-right corner; clicking it opens the assistant in a panel. On a phone the panel fills the screen. Escape closes it.

If nothing appears, open the browser console. A bad or missing data-linwick logs one line naming that attribute, and the script deliberately renders nothing rather than leaving a dead button on a live site.

03

Optional attributes

All optional. Add them to the same tag.

AttributeWhat it doesDefault
data-linwickYour account's slug. This is the only required attribute.Required — without a valid one the script adds nothing to the page.
data-labelThe words on the button.Get a quote
data-accentButton colour, as a six-digit hex code such as #1d4ed8.#111827 (near-black)
data-positionWhich corner the button sits in: "left" or "right".right
<script src="https://www.linwick.co.uk/embed.js"
        data-linwick="your-slug"
        data-label="Ask about cleaning"
        data-accent="#1d4ed8"
        data-position="left"
        defer></script>

04

What it does to the page, exactly

This is the part a developer is right to ask about before adding somebody else’s script to a site they maintain.

  • Appends one <div> to the end of the body and puts everything inside a shadow root, so no style of ours can reach your CSS and none of yours can break ours.
  • Sets no cookies, reads no cookies, and stores nothing in localStorage on your domain.
  • Sends no analytics, no tracking, and no request at all until a visitor clicks the button.
  • Loads the assistant in a sandboxed <iframe> on our origin, not inline. It cannot read your page, and it cannot navigate it.
  • Adds no jQuery, no framework, no polyfill, and no second file. It is one script of a few kilobytes.
  • Does not modify, move, hide or restyle anything already on the page.

Content Security Policy, if the site has one: allow script-src and frame-src for https://www.linwick.co.uk. Nothing else is required.

05

Or skip the website entirely

The assistant is also a plain link, and it is the same page the button opens:

https://www.linwick.co.uk/c/your-slug

An email signature, a Google Business profile, a QR code on a quote, a social post. Nothing needs installing for that to work.

Stuck, or something behaving oddly on a particular site? Email adrians@stepedigital.com with the page address and we will look at it. More answers on the questions page.