Shopify Installation

Add Grounded chat widget to your Shopify store.

Add the Grounded chat widget to your Shopify store to provide instant customer support.

Installation Steps

1. Access Theme Editor

  1. Go to your Shopify admin panel
  2. Navigate to Online Store > Themes
  3. Click Actions > Edit code on your current theme

2. Edit Theme File

  1. In the left sidebar, find the Layout folder
  2. Click on theme.liquid
  3. Scroll to find the closing </body> tag
  4. Add the widget code just before it:
<script
  src="https://grounded.sh/widget/grounded-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>
</body>
  1. Click Save

Using Shopify App Blocks (Theme 2.0)

If your theme supports app blocks:

  1. Go to Online Store > Themes
  2. Click Customize
  3. In the theme editor, click App embeds (puzzle piece icon)
  4. Unfortunately, Grounded doesn't have a Shopify app yet - use the code method above

Best Practices for E-commerce

Train on Product FAQs

Add these as knowledge sources for better support:

  • Shipping policy page
  • Returns and refunds page
  • Size guides
  • Product care instructions
  • FAQ page

Handle Order Inquiries

Grounded can answer general questions about your policies but cannot access order-specific information. Set up human handoff for order status inquiries.

Troubleshooting

Widget Not Showing

  1. Preview your theme to confirm the widget appears
  2. Check if any Shopify apps are blocking third-party scripts
  3. Verify you're editing the active theme
  4. Clear Shopify's cache by saving the theme file again

Mobile Display Issues

The widget is responsive by default. If you have issues:

  1. Check your theme's mobile CSS isn't hiding fixed elements
  2. Ensure no overflow: hidden on body/html
  3. Test in Shopify's mobile preview mode