A Theme App Extension app embed — toggle on in the theme editor, paste your Tenant Key, save. No theme code edits, no theme swaps to redo.
Sign up free — passwordless sign-in by email, no credit card. The free plan includes the website widget and a sandbox tenant.
*.myshopify.com domain (and your custom domain if any).chat_…).The OrcaLinq Shopify app ships a Theme App Extension that adds an App Embed block to your theme. The merchant enables the embed in the theme editor and pastes the Tenant Key — no theme.liquid edit required.
The Theme App Extension produces:
<script
async
src="https://api.orcalinq.com/w.js"
data-tenant="chat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
data-api="https://api.orcalinq.com"
data-color="#1A3C5E"
data-position="bottom-right"
data-shop="your-store.myshopify.com"
data-installed-by="shopify-app-embed@0.1.0"
></script>Plus a one-time heartbeat call to /api/widget/install/check so the OrcaLinq Admin install card flips green even if a content blocker eats the bubble script.
For merchants who don't want to install another Shopify app or have heavy custom-theme control.
layout/theme.liquid.</head>.v1 (the current version) installs the widget only. The AI answers from approved knowledge (FAQ, policies, indexed public pages) and hands off when live order data is needed.
v2 will add an opt-in Shopify data connector for live order lookup, fulfillment status, return eligibility, customer identity, stock and availability, and product detail. Separate authorization, separate scopes, separate audit trail. A merchant can install the widget today and decide later whether to authorize the data connector.
Confirm the App Embed is toggled on (not just added — toggled on too). Confirm credentials are pasted in the block settings. View source on a storefront page and search for api.orcalinq.com/w.js — if missing, the embed isn't activated. Click Verify installation in the OrcaLinq app for the server-side diagnosis.
If the storefront is behind edge bot protection, it might be filtering the heartbeat. Allowlist api.orcalinq.com in your security provider.
The shop's *.myshopify.com domain must be added in OrcaLinq Admin → Domains. The Shopify app's install flow should add it automatically; if it didn't, add manually. Custom shop domains (shop.example.com) need to be added separately.
Yes. The Theme App Extension works on all paid plans (Basic, Shopify, Advanced, Plus). Shopify Lite (no online store) is the only exception.
Both can coexist on the same store, but most merchants pick one. OrcaLinq's semantic PBX shape (AI-first answering with confidence-driven handoff, multi-channel routing, agent-native endpoints) is different from Shopify Inbox (a unified inbox with no AI grounding); choose based on what you need.
No. The widget install uses only the Theme App Extension permission. Live order data, customer lookup, etc. require the separate Shopify data connector (v2 roadmap), which adds <code>read_orders</code>, <code>read_customers</code>, <code>read_inventory</code>, etc. as opt-in scopes.
The widget loads on the storefront. Conversations live in the OrcaLinq Admin Portal (or get routed to the agent's Telegram/WhatsApp/PWA). It's not an inbox replacement; it's an AI-first conversation conductor that runs alongside your support stack.
Once listed on the Shopify App Store, updates ship via the standard Shopify auto-update channel. Theme App Extension code is versioned — Shopify pins each store to a specific version until the merchant updates.
Open the OrcaLinq app's Verify installation panel in Shopify Admin for a live diagnosis, or sign in to your <a href="https://app.orcalinq.com">tenant admin portal</a>.