Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.digifist.com/llms.txt

Use this file to discover all available pages before exploring further.

The storefront widget adds a WhatsApp chat button to your Shopify store. When a customer taps it, they are connected to your WhatsApp Business number and a conversation is created in the Galantis Inbox. Galantis injects the widget via a Shopify script tag — no manual theme editing is required.

​
What this covers

  • Installation steps and how script injection works
  • Placement options
  • How to verify the widget is live on your storefront
  • Troubleshooting widget display issues

​
How installation works

Galantis uses Shopify’s script tag system to inject the chat widget into your storefront automatically. When you configure the widget in the dashboard, Galantis writes a script tag to your store using the write_script_tags Shopify permission. The widget loads on every page that matches your display rules without any changes to your theme code.
The write_script_tags Shopify permission must be granted for widget injection to work. This permission is requested during the initial app installation. If the widget is not appearing, verify this permission is active under your Shopify app settings.

​
Installation steps

1

Open Widget Settings

In the Galantis dashboard, go to Inbox → Widget Settings.
2

Configure appearance

Set the button position, label text, colors, and greeting message. See Widget Appearance for the full settings reference.
3

Save settings

Saving the configuration triggers Galantis to write or update the script tag in your Shopify store. No further action is required to deploy the widget.
4

Verify on your storefront

Visit your store in a browser. The chat button should appear in the configured position. Test by tapping the button — it should open WhatsApp pre-populated with your business number.

​
Placement options

The widget button can be positioned in three ways: Bottom-right — Default position. Works well for most store layouts and does not conflict with common Shopify theme elements. Bottom-left — Use when your theme places other fixed elements (such as cookie banners or cart drawers) at the bottom-right. Custom — Set a precise position using CSS offset values. Useful when neither default position works with your theme’s layout.

​
Display rules

You can control which pages the widget appears on. Common configurations include:
  • Show on all pages
  • Show only on product pages
  • Hide on the checkout page
Display rules are configured under Inbox → Widget Settings.

​
Verifying the widget

After saving your settings, confirm the widget is working correctly:
  1. Open your storefront in a browser (not the Shopify theme preview).
  2. The chat button should appear in the position you configured.
  3. Tap the button — it should launch WhatsApp with your business number pre-filled.
  4. Send a test message — it should appear as a new conversation in Inbox.

​
Troubleshooting

If the widget does not appear on your storefront:
  • Confirm Galantis has write_script_tags permission in Shopify Admin → Apps → [Galantis] → Permissions.
  • Clear your browser cache and reload the storefront page.
  • Check your browser console for JavaScript errors that may indicate a script loading conflict.
  • Confirm the page you are viewing matches your configured display rules.
The Shopify theme preview editor may not execute third-party script tags. Always verify the widget on your live storefront URL, not inside the Shopify Customizer preview.