Skip to main content

Global settings

Global settings control the default behavior and appearance of every "ShopGuide Chat" block on your store. They live in the ShopGuide admin app (not in the Shopify theme editor) and apply everywhere unless a specific block on a page has "Use custom settings" enabled to override them.

Accessing Global Settings​

  1. Open the ShopGuide app from your Shopify admin
  2. Go to the Settings page for behavior, launch messages, and the bubble
  3. Go to the Appearance page for colors, style template, and container sizing

Appearance Page​

Style Template​

Three built-in visual styles, applied to every chat widget:

  • Classic — traditional design with solid backgrounds, borders, and shadows
  • Floaty — modern glassy design with ambient glow effects and transparent elements
  • Bubbly Glow — rounded, iOS-style bubble with a soft shimmering color outline and a frosted-glass fill

Each template ships with its own defaults for shadows, borders, dividers, and corner radii, which you can still fine-tune individually.

Colors​

  • User message background/text color and bot message background/text color
  • Container background color, optional border (color/width/radius), and optional drop shadow (offset X/Y, blur, opacity)
  • Divider color, thickness, and spacing between messages

Dimensions and Shapes​

  • Outer container corner radius, chat bubble corner radius, input/button corner radius
  • Container width, padding, and margin
  • Maximum chat height on desktop and on mobile (as a percentage of viewport height)
  • Profile image toggle, image URL, and display size

General Settings​

  • Chat heading text, send button label, and input placeholder text
  • Show/hide the chat header, the login button, and the AI disclaimer ("This AI Guide can make mistakes...")
  • Header text color

Settings Page​

Bubble​

  • Position: left or right (the chat always renders as a fixed floating bubble — see Chat positioning & layout)
  • Size and icon (sparkles, chat, message, question, robot, or search), plus icon color
  • Show/hide the floating bubble anchor
  • Product card layout: side panel (desktop) or horizontal scroll (in-chat)

AI Behavior​

  • Custom system prompt — see Custom system prompts
  • Auto-Scroll — after an idle delay (default 120 seconds) on a product page, the page scrolls to the chat and it opens with a short, context-aware AI-generated check-in message. Can be scoped to product pages only (default) or enabled globally on every page type. See Custom launch messages.
  • AI Discount Code Generator (if enabled, lets the AI create time-limited discount codes for eligible products/collections)

Essential Settings​

  • Pause chat storefront-wide — a single toggle that disables the widget across the entire store without removing the theme block
  • Hide on desktop / Hide on mobile — see Mobile & desktop chat settings
  • Global, collection-page, and product-page custom launch messages (with buttons), each resolved per storefront language — see Custom launch messages
  • Allow customers to delete their own chat transcript

Setting Inheritance and Overrides​

  • Global settings apply to every "ShopGuide Chat" block by default.
  • An individual block (added via the theme editor on a specific page) can enable "Use custom settings" to override the chat heading and primary color for that page only — everything else still comes from global settings.
  • A block can also enable "Use custom launch message" to replace the page's launch message and buttons regardless of the global/product/collection launch message configuration.

Next Steps​