The Gorgias Shopify chat bubble: a complete setup and customization guide (2026)

The Gorgias chat bubble is one of those tools that most Shopify merchants set up once and then never think about again - until it disappears after a theme update, or customers start complaining that the AI responses sound robotic, or they realize the widget they have been using for two years is not actually configured to its full potential.

This guide covers all of it: how to install the widget in a way that will not break, how to customize it beyond the defaults, what the native AI can genuinely do versus where it falls short, and how to make the whole setup smarter. If you are looking for a broader overview of what Gorgias chat is, we covered that in What is the Gorgias chat used for? - this guide goes one level deeper on the widget itself.

What the Gorgias Shopify chat bubble is

The Gorgias chat bubble is a floating widget that sits in a corner of your Shopify storefront. When a shopper clicks it, they open a live chat window to reach your support team - or, if you have AI Agent configured, to self-serve common questions without involving a human. Every conversation creates a ticket in your Gorgias helpdesk, with the customer's full Shopify order history automatically visible in the sidebar.

Chat is included on all Gorgias plans, from the Starter plan at $10/month. The AI automation features layered on top - Gorgias's own AI Agent for automatic replies, interactive Flows, AI FAQs - are a separate subscription. That distinction matters: the widget itself is a reliable, customizable foundation. The frustration merchants run into is almost always with the AI sitting behind it, not with the chat bubble itself.

Gorgias is Shopify's only Premier Partner for customer experience, which means the integration runs deeper than most alternatives. Agents see real-time Shopify order data alongside every conversation, and the AI Agent (when active) can take direct order actions - refund, edit, track - without leaving Gorgias.

How to install the chat bubble on Shopify

The right way: Quick install

Setting up the chat bubble takes about five minutes. In your Gorgias helpdesk, go to Settings → Channels → Chat and click + New chat. The setup wizard walks through five steps:

1. Basics - name the integration, set a default language, choose your store, and select whether to allow live chat or offline-capture-only messages.
2. Branding - pick a brand color (hex code or color picker), upload a logo, and set the widget's corner position.
3. Order management - enable or disable self-serve order tracking in the widget.
4. Install - the critical step.
5. Deploy AI Agent - optional, requires an AI Agent subscription.

On the Install step, choose Quick install for Shopify. This installs the widget at the app layer rather than injecting it into your theme code. It covers every page of your store automatically and stays put even when you update or switch themes.

When manual install makes sense

Manual install is worth choosing when you need the widget on specific pages only, you are running a headless Shopify store, you are on BigCommerce or Magento 2, or you are deploying through Google Tag Manager. For any standard Shopify store where you want the widget everywhere, Quick install is the right call.

Why your chat bubble keeps disappearing

The most common Gorgias chat issue in Shopify community threads: merchants notice the bubble is gone, almost always after a theme update or switch. The Shopify community forums have been discussing this for years - the answer is always the same. The store was using manual install, and the theme change overwrote the injected script.

The fix: Settings → Channels → Chat → Installation tab → click the pencil icon → switch to Quick install for Shopify. Once switched, it will not happen again.

One quirk worth knowing: the "Not detected" status in the Installation tab is based on visitor traffic from the past 72 hours. If your store had no visitors recently, the status can read "Not detected" even when the widget is live. Visit a page on your store and reload it - if the bubble appears, the installation is fine.

Customizing how the widget looks and behaves

Most merchants stick with the defaults, but the Gorgias chat widget is more configurable than it looks. From Settings → Channels → Chat, the appearance options include:

• Brand color - hex code input or color picker; solid fill or gradient
• Company logo - separate logos for open (chat expanded) and closed (bubble only) states
• Font - a full dropdown selection
• Chat title - shown in the header when the shopper opens the widget
• Intro messages - separate text for business hours vs. outside hours
• Chatbot label - toggles the "Bot" label next to automated messages, useful for setting honest shopper expectations
• Launcher type - standard floating bubble or a custom text label
• Widget position - any corner, with pixel-level offset control for horizontal and vertical placement

One genuine constraint: the widget size is not adjustable. Gorgias sets it dynamically. On small screens, it automatically switches to fullscreen - this is expected behavior. On the Shopify checkout page, the widget is always locked to the bottom-right corner regardless of your position setting elsewhere.

If you want the widget hidden on specific pages - useful when an FAQ page already handles the queries that would normally go to chat - go to Settings → Chat → Installation tab → pencil icon → "Hide on specific pages."

Enabling self-serve order tracking in chat

One of the highest-value configurations in the chat widget is enabling order management. With a Gorgias AI Agent subscription and a connected Shopify store, shoppers can check their order status, tracking number, and shipping info directly in the chat window - without a human agent involved at all.

Gorgias flagged this in their own community posts as "the single most effective thing you can do to reduce your ticket volume for BFCM." For stores seeing high WISMO volume, it is the configuration that delivers the clearest ROI. Our Gorgias for Shopify guide covers more of the automation setups worth building on top of the chat widget.

Order management is on by default when you set up a new chat integration with AI Agent active. To check or enable it on an older setup: Settings → AI Agent → Deploy → Chat → toggle "Enable order management."

Setting up business hours and offline mode

Outside your support hours, the widget can switch to offline capture mode. Shoppers can still open it and send a message, but it routes as an email ticket rather than a live chat session. You can write a distinct intro message for this state and optionally display a different logo.

During live hours, the widget shows a dynamic estimated wait time. Set your business hours in Settings → Channels → Chat → your integration → Business Hours tab.

Multi-language support works through browser detection: the widget auto-detects the shopper's browser language, displays in it if you have configured that language, and falls back to your default if not. Add languages under the Basics tab by clicking + Add language.

What the native chat AI can (and can't) do

The Gorgias AI Agent, deployed on chat, handles order tracking, return policy questions, and FAQ-style queries reasonably well. Accuracy improved from 3.55/5 in earlier periods to 4.08/5 through 2025. For high-volume repetitive queries - order status, subscription questions, standard return policies - it is genuinely useful, and brands like Orthofeet achieved 56% automation in under two months.

Where it runs into trouble is with anything more nuanced. The r/shopify community is blunt about it:

"Yeah I felt the same with Gorgias. It sounded too 'bot-ish' and customers didn't vibe with it."

u/No_Project_8158, Aug 2025

"yeah i was excited about gorgias ai when it came out...the ai was trash. it kept looping the same stuff, pissed off sooo many customers, had chargebacks because the bot promised refunds, closed the ticket but never refunded those people."

u/MindFull_, Aug 2025

Part of this is structural: Gorgias AI learns primarily from data within the Gorgias ecosystem - tickets, macros, help center articles. If your product documentation lives in Confluence, Google Docs, or Notion, the native AI cannot access it. Responses are limited to what Gorgias itself has indexed.

The pricing compounds the frustration. At $0.90-$1.00 per resolved conversation (charged only for fully autonomous resolutions), merchants handling significant AI volume can see bills that dwarf their base plan. One r/shopify merchant scaling to 1,500 tickets/month estimated $500+ per month for roughly 400 AI resolutions and was questioning whether AI automation was worth it at all.

For a detailed breakdown of how these costs stack up at different automation rates, our complete guide to Gorgias automate AI for Shopify has the numbers.

Making the chat bubble smarter with eesel

eesel AI is not a separate chat widget sitting alongside Gorgias - it works as a native Gorgias agent. When a ticket comes in through your chat bubble, eesel reads it, drafts a reply, adds internal notes, and updates tags, all from within Gorgias. The shopper experience does not change. Your agents do not learn a new tool. The AI just handles more.

The key difference is knowledge breadth. eesel connects to your complete knowledge base - Gorgias help center articles, historical tickets, macros, plus external sources like Google Drive, Confluence, and Notion - so replies can draw on anything your team has documented, not just what lives in Gorgias. If a policy lives in a Notion doc, eesel finds it. If a common question was answered in a Confluence page six months ago, eesel uses that answer.

Before going live, you can run eesel against historical Gorgias tickets to preview how it would have responded - the simulation step that catches "bot promised a refund" moments before they reach a real shopper. Setup takes about 30 minutes.

Pricing is $0.40 per ticket - not per resolved conversation. You pay a flat rate per interaction, not a premium when the AI works well. Merchants on Gorgias typically see an 85%+ tier-1 resolution rate within the first week.

"eesel AI wasn't just another chatbot for our Gorgias helpdesk. It was the glue..."

Years.com

For teams looking at the broader picture of Shopify automation or comparing different chat tools, our best Shopify chatbot apps guide covers the full landscape.

Troubleshooting common issues

Chat bubble not showing after installation Visit a live page on your store and reload. "Not detected" in settings is a traffic-based status - if no one visited in the past 72 hours, it shows "Not detected" even when the widget is working. Check the live page directly.

Chat disappeared after a theme update You are on manual install. Switch to Quick install: Settings → Channels → Chat → Installation tab → pencil icon.

Widget displaying incorrectly on mobile On small screens, the widget goes fullscreen automatically. That is the expected behavior. If you see the widget cut off or mispositioned on mobile, check whether custom CSS is interfering with the widget's z-index.

Widget locked to bottom-right on checkout The checkout page always positions the widget in the bottom-right corner regardless of your settings. This is a Shopify platform constraint, not a configurable option.

iOS webview not loading the chat Add about:srcdoc to the webview's originWhitelist. Without this, the chat widget will not load in an iOS webview context.

Agent avatar not updating Avatar changes take up to five minutes due to caching. Clear your browser cache and reload if it has been longer than that.

Try eesel

If your Gorgias chat bubble is set up but the AI responses are frustrating customers - or if you want AI that draws on your full knowledge base rather than just what Gorgias has indexed - eesel AI slots directly into your existing Gorgias setup. No new widget, no separate tool, no retraining your team.

The eesel for Gorgias integration page has the full details, and the free trial starts with $50 in credit, no card required.