Install · Shopify

Not in the App Store yet. You can still install today.

Search the Shopify App Store and you will not find us — the listing is not live. That does not block you. Paste one line into your theme and the chat runs on your storefront in about five minutes, with nothing to undo when the app does list.

Straight answer

What you can and cannot do right now

  • You can install the chat today, on any Shopify plan with an online store, by editing one theme file. Steps below.
  • You cannot install it from the App Store. There is no public listing, so there is no "Add app" button to press.
  • You cannot build your own install link either. Shopify requires an install link to be signed by Shopify before it will show you the approval screen. A hand-typed address is rejected. That is Shopify's rule, not a setting we can waive.
  • An early-access install can be arranged — an unlisted install is possible without a public listing. Write to support@orcalinq.com with your .myshopify.com address if you want one. But do not wait on it to go live; the theme paste below is the same widget.
Install today

Paste one line into your theme

This is the supported path while the listing is pending. Nothing about it is a workaround.

First get your snippet: sign in at app.orcalinq.com → Domains → your store → Installation → copy the box. It looks like this, with your own key in place of chat_YOURKEY:

<script async src="https://api.orcalinq.com/w.js"
        data-tenant="chat_YOURKEY"
        data-api="https://api.orcalinq.com"></script>
  1. Shopify admin → Online Store → Themes.
  2. On your live theme, click the button → Edit code.
  3. In the Layout folder, open theme.liquid.
  4. Find </head> — press Ctrl+F or Cmd+F and search for it.
  5. Paste the snippet on the line just above </head>.
  6. Save, top right. It is live on every storefront page immediately — no republish step.

Check it: open your storefront in a private window. The bubble appears within about two seconds.

Do not use Shopify Custom Pixels for this. Pixels run inside a sealed frame that cannot draw anything on your storefront, so the chat will never appear. theme.liquid is the path that works.

No Edit code option? Some staff accounts do not have theme-editing permission. Ask the store owner to grant it, or to do these six steps once — after that nothing needs touching again.

Also do this

Register the store's web addresses

The chat only starts on addresses you have registered, so add them in Domains:

  • Your .myshopify.com address.
  • Your custom shop address, if you have one. It is a separate entry — adding one does not add the other.

If your store is still behind a storefront password (Online Store → Preferences → Password page), the DNS, meta-tag and file checks cannot see past it. Use the Widget already running verification method instead: install the snippet first, then let us detect it.

Later

What changes when the app arrives

The app is a different way to deliver the same script tag. It does not add features to the chat itself.

  • You get an App embeds block in the theme editor — a toggle and a field for your key, instead of editing theme code.
  • It asks Shopify for one permission only: read access to your themes. It does not ask for orders, customers or inventory.
  • Live order lookup, fulfilment status and stock answers are a separate connector, authorised separately, and not part of this version. Until then the chat answers from your approved content — policies, FAQs, public product pages — and hands over to a person when it needs real order data.

An early-access install runs like this: Shopify shows you the permission screen; you approve; you land on a page on app.orcalinq.com that names your store and offers to link it to your account. If it says the store is already linked to another account, that is a real conflict — write to support@orcalinq.com rather than reinstalling.

Then, in Shopify: Online Store → Themes → Customize → open the App embeds panel (the puzzle-piece icon) → switch on the OrcaLinq Widget block → paste your key into Tenant KeySave.

If the theme editor shows a dashed grey box saying the embed is on but no key has been entered, that is the block telling you the Tenant Key field is empty. Only you see it — it is not shown to shoppers. Open the block's settings on the right and paste the key.

Already pasted into theme.liquid and now switching to the embed? Remove the line from theme.liquid first. Do not leave both in place: the loader has no guard against being included twice, so two copies of the tag put two chat bubbles on your storefront. Delete one, save, then check the storefront in a private window.

If that did not work

When the bubble does not show up

  • You saved theme.liquid but see nothing. Check you edited the theme that is actually published, not a duplicate. In Online Store → Themes the live one is at the top under Current theme; everything below it is unpublished.
  • You pasted into the wrong file. It must be layout/theme.liquid. Files under sections/ or templates/ only cover part of the store.
  • The key is still the placeholder. If the tag on your storefront reads chat_YOURKEY or YOUR_API_KEY, no chat will load. See how to get your real widget key.
  • Your storefront is behind bot protection. If you have added an edge security service in front of the store, allow api.orcalinq.com so the chat can reach us.
  • Still nothing. Run Domains → Installation → Diagnose in your dashboard. It fetches a live storefront page from our side and names the cause, which saves a round of messages.

A missing listing is not a missing product.

Six steps in your theme and the chat is answering shoppers today. The app embed is a convenience you can adopt whenever it lands.