Install · WordPress

No plugin file? Install the one line instead.

Our WordPress plugin is a convenience, not a requirement. The chat is one script tag. If the download gave you nothing, paste the tag yourself and you are live in about five minutes — with exactly the same result.

Open your dashboardThe plugin guide
Step 1

Copy your snippet

Everything below pastes the same tag. You need your own widget key in it.

Sign in at app.orcalinq.com, open Domains, pick your website, then the Installation tab. The snippet box there already has your key filled in — use the copy button beside it.

If you would rather type it, this is the whole tag. Replace chat_YOURKEY with your key; the rest is already correct:

<script async src="https://api.orcalinq.com/w.js"
        data-tenant="chat_YOURKEY"
        data-api="https://api.orcalinq.com"></script>

The box shows YOUR_API_KEY instead of a key? That means the browser you are in has no copy of it. Do not press Mint key on a site that is already live — read how to recover your widget key first.

Step 2 · easiest path

Use a header plugin you probably already have

These plugins exist to hold snippets like ours. Nothing to build, no theme file to touch, and the snippet survives theme updates.

  1. WordPress admin → Plugins → Add New Plugin → search for WPCode. (On older WordPress the menu is just Plugins → Add New.)
  2. Install Now, then Activate.
  3. Left menu → Code Snippets → Header & Footer.
  4. Paste the snippet into the Header box.
  5. Save Changes. It now loads on every public page.

WPCode not in the search results, or you already have something similar? Any plugin with a header-scripts box does the same job — Insert Headers and Footers by WPBeginner and Code Snippets are the other common ones. The box you want may be called Header, Scripts in Header, or Site Wide Header. If a plugin offers only a footer box, that works too; the bubble simply appears a moment later.

Step 2 · alternative

If you cannot install any plugin at all

Some hosts and some company policies block new plugins. Then edit the theme header directly.

  1. WordPress admin → Appearance → Theme File Editor.
  2. In the file list on the right, open header.php.
  3. Find </head> — use Ctrl+F / Cmd+F in the editor box.
  4. Paste the snippet on the line just above it.
  5. Update File.

No Theme File Editor in the Appearance menu? That is expected on a modern block theme — WordPress hides the editor there, and those themes have no header.php to edit. It can also be switched off deliberately by your host. In both cases go back to the plugin path above; there is no third option on the same theme.

One thing to know before you edit a theme file. Updating the theme can overwrite header.php and take your snippet with it. If the chat vanishes after a theme update, that is why — paste it back, or move to the plugin path so it stops happening.

Step 3

Check it is running

  1. Open your homepage in a private window. The bubble appears within about two seconds.
  2. Using WP Rocket, W3 Total Cache, LiteSpeed Cache or similar? Purge the page cache first. Until the cached HTML is rebuilt your visitors are served the old page without the snippet in it.
  3. Still nothing? In your dashboard open Domains → Installation → Diagnose. It fetches your live page from our side and names the cause.
Honestly

Why the download gave you no file

The plugin is not distributed from this website. It is published into a versioned catalogue, and the download link asks that catalogue for the newest build. If no build has been published yet, there is no file to hand you — so the link returns a short line of error text rather than a download, and the Downloads page in the dashboard hides the download button for WordPress entirely rather than offering one that fails.

You can see the true state for yourself. Open this in any browser — no sign-in needed:

https://api.orcalinq.com/api/installers

Find the wordpress entry. If its versions list is empty and latest_version is empty, there is genuinely nothing to download today and the manual snippet above is the supported way in. If a version is listed, the download link should work:

https://api.orcalinq.com/api/installers/file/wordpress/latest

That link needs no account, so a sign-in prompt is never the reason it fails. Two things that do interfere: an office or school network that blocks .zip downloads, and a phone browser that opens the file rather than saving it. WordPress needs the zip file itself, so download it on a computer.

There is nothing you lose by pasting the snippet instead. The plugin injects the same tag; it just also manages your content-security settings and reports install status back to us.

If that did not work

Common causes, in the order they happen

  • The snippet is in the page source but the bubble never appears. Some managed WordPress hosts strip inline scripts out of theme files while leaving them visible in the saved file. Switch to the WPCode path — it inserts the snippet through a WordPress hook that hosts do not strip.
  • A security plugin is blocking it. Wordfence, Sucuri, Solid Security and Really Simple SSL Pro can each set a strict content-security policy. Add api.orcalinq.com to both script-src and connect-src in that plugin's rule.
  • The chat works on www. but not without it, or the other way round. Those count as two websites. Add both in Domains, or add a single wildcard entry for the domain.
  • You pasted it and then it disappeared. Either a theme update overwrote header.php, or a caching layer is still serving the old page. Check the page source first: if data-tenant is missing from it, the snippet is gone rather than blocked.
  • Nothing above fits. Run Domains → Installation → Diagnose and send us what it says, at support@orcalinq.com. That output tells us in one step what a screenshot cannot.
Related pages

Keep exploring

One line is the whole install.

The plugin is a shortcut. If the shortcut is closed, the front door still works.

Open your dashboardAll install guides