Global settings
Global settings are the defaults for every ShopGuide Chat block on your store — set once in the admin app, applied everywhere, unless a specific block on a page turns on "Use custom settings" to override it.
Where to find them
Open the ShopGuide app from your Shopify admin. The Settings page covers behavior, launch messages, and the bubble. The Customize page covers colors, the style template, and container sizing.
On the Customize page
Four style templates are available: Classic ("Clean & Traditional": solid backgrounds, borders, shadows), Floaty ("Glassy & Modern": glassy, ambient-glow, transparent), Bubbly Glow ("Bubbly & Shimmering": rounded, iOS-style, soft shimmering outline with a frosted-glass fill), and Guide (experimental) ("Points at the page": the chat floats beside the section a shopper is reading and points at parts of the page; see Guide mode). New installs start on Floaty; shops that never picked a template stay on Classic. Each template ships its own defaults for shadows, borders, dividers, and radii, and you can still fine-tune each one after picking it.
Colors cover user and bot message backgrounds and text, container background, an optional border (color, width, radius), an optional drop shadow (offset, blur, opacity), and divider color, thickness, and spacing. The default primary color for new shops is #2E9AB3.
Dimensions and shapes cover the outer container radius, chat bubble radius, input/button radius, container width, padding, margin, maximum chat height on desktop and mobile as a percentage of the window, and the profile image toggle, image, and size. For new shops and when you switch template, the desktop maximum height starts at 45% and mobile at 50% (42% on the Guide template); shops with saved settings but no stored height stay at 35% on desktop.
General settings cover the chat heading, send button label, input placeholder text, whether the header shows, Show login button (off by default, and only active while the header is shown), Show 'presented by' branding (the "Your AI Guide is presented by yourshopguide.com" line at the bottom of the chat; turn it off to white-label the chat), Shimmer greeting text (off by default), and header text color. The Custom CSS field is on this page too; see Advanced chat styling.
On the Settings page
Settings has seven tabs.
Essentials holds the store language (detected, read-only), the Primary color (the same value as User background color on the Customize page), the Global Custom Launch Message, the collection-page and product-page launch message checkboxes (see Custom launch messages), and the support channel (Email, Slack, or WhatsApp).
AI Behavior covers free shipping information, Your instructions to the AI (see Custom system prompts), Auto-Scroll Settings, Sidekick access, the AI Discount Code Generator, email follow-up on unanswered questions, NPS surveys, web research settings, product comparison metafields, and AI feedback management. Auto-Scroll ("Enable automatic scrolling to chat", on by default) scrolls the page to the chat after an idle delay, 120 seconds by default; it applies to product pages unless you tick Enable on all pages (global).
Bubble covers the mobile navigation setting, product card layout (Side Panel (Desktop) or In Chat (Horizontal Scroll)), the chat bubble itself, proactive messages, and the AI notification bar, described below.
General holds the Global Kill Switch (pauses chat and A/B tests store-wide; see Visibility controls), transcript management ("Allow transcript deletion", so customers can delete their own chat transcript), order features (order tracking and order editing), debug mode, the dashboard sessions filter ("Count only sessions from countries you sell to"), and Enable Drawer Mode (experimental).
Billing, Store Setup, and Integrations cover your plan, setup steps, and connected apps.
The chat bubble
Under Chat Bubble Settings: Display Bubble, position (Right or Left; the chat always renders as a fixed floating bubble, see Chat positioning & layout), Bubble size (px), and Bubble icon: Sparkles (AI), Chat, Message, Question, Robot, Search, or Custom image (upload). With a custom image you pick the file under Custom bubble icon (upload to Shopify Files, choose from Files, or paste a URL) and decide with Fill the whole bubble whether it covers the bubble as a cropped circle (good for photos) or sits centred (good for logos). The Bubble icon color is hidden while a custom image is in use, and the default chat icon shows until an image is set.
Proactive messages
Proactive Messages shows a short message next to the bubble after a delay: Enable proactive messages, a Message text per language (falling back to your primary language), and Show after (seconds), 1 to 30. Personalized Proactive Message (beta) is a separate, opt-in setting, off by default; see Personalized proactive bubble.
AI notification bar
Enable AI notification bar shows a bar at the bottom of the screen with the latest AI message while the chat is not visible. It is off by default for new shops; shops that saved their settings before that change keep it on. Visitors can minimise it to a small round pill, and it stays minimised for that visit.
How overrides stack
Global settings apply to every block by default. A block added via the theme editor on a specific page can turn on "Use custom settings" to override just the Chat Heading and Primary Color for that page — everything else still comes from global. A block can separately turn on "Use custom launch message" to replace that page's launch message and buttons, regardless of what the global/product/collection configuration says.