Skip to main content

Shopify theme editor basics

Adding the ShopGuide chat widget means spending a few minutes in Shopify's theme editor. Here's the part of it that actually matters for that.

Getting there

From your Shopify admin, go to Online Store, click Themes, find your active theme (marked as current), and click Customize.

Once you're in, the left sidebar holds Sections (add, remove, configure), Theme settings (global config), and a page selector to switch between templates — home, product, collection, and so on. The center panel is a live preview with device toggles for desktop and mobile. The top toolbar has Save, Preview, and Exit.

You'll need an Online Store 2.0 theme

The ShopGuide Chat block is a Shopify theme app extension block, and those only work with Online Store 2.0 themes — the current generation, which includes Dawn and most themes currently sold in the Theme Store. Older themes don't support app blocks at all. If your editor has no "Add Section" option, or no Apps category underneath it, the theme needs upgrading or replacing before ShopGuide can go in through the editor.

Adding the block

Open the editor on the page where you want the chat, click Add Section, open Apps, click ShopGuide Chat, and save. Since the block always renders as a fixed floating bubble, where you place it in the section list doesn't affect where it shows up on screen — see Chat block & app embed setup for the full walkthrough and every setting on the block.

Checking mobile and desktop

Theme editor changes apply to all devices by default. ShopGuide's own device-specific controls — hide on desktop/mobile, max height, drawer mode — live in the ShopGuide admin app instead, not the theme editor; see Mobile & desktop chat settings. Either way, check both previews after adding or reconfiguring the block.

A habit worth having: duplicate your theme first

Go to Online Store > Themes, click Actions on your current theme, and select Duplicate. Name it something you'll recognize later — "Backup — before ShopGuide" works fine. Make changes in the duplicate or in preview mode, confirm the chat appears and works, then publish.

If the block won't show up

Confirm your theme is Online Store 2.0, confirm ShopGuide is installed with an active subscription or trial, and refresh the editor with your browser cache cleared. If the styling doesn't match your brand, that's adjusted on the ShopGuide admin app's Appearance page (see Chat appearance & branding) or, for anything the settings UI doesn't cover, through Advanced chat styling.

Next steps