Skip to main content

Widget Installation

How to add the TrolleyChat widget to your website.

Shopify​

No code required — TrolleyChat installs as a Shopify app embed.

  1. In your Shopify admin, go to Online Store → Themes
  2. Click Customize on your active theme
  3. Go to App Embeds (in the left sidebar)
  4. Toggle TrolleyChat on
  5. Make sure your Inbox ID and Widget ID are filled in (you can find these in the Settings section of the TrolleyChat app)
  6. Click Save

That's it — the widget will appear on your store automatically.

WordPress​

  1. Go to Appearance → Theme Editor
  2. Open header.php
  3. Paste the widget code just before </head>
  4. Click Update File

The widget code snippet:

<script
  src="https://app.trolleychat.ai/widget.js"
  data-inbox-id="YOUR_INBOX_ID"
  async
></script>

You can find your Inbox ID in the Settings section of the TrolleyChat app.

Other Platforms​

For any other website, paste the widget code into the <head> section of your site's HTML. If you're not sure where that is, check your platform's documentation for "adding custom scripts" or "header code."

<script
  src="https://app.trolleychat.ai/widget.js"
  data-inbox-id="YOUR_INBOX_ID"
  async
></script>

Verify It's Working​

After adding the widget:

  1. Visit your website
  2. Look for the chat bubble in the bottom-right corner
  3. Click it and send a test message
  4. Check your TrolleyChat dashboard — the message should appear there

Troubleshooting​

Widget doesn't appear​

  • Make sure your Inbox ID and Widget ID are correct (check Settings in the TrolleyChat app)
  • For Shopify, make sure the app embed is toggled on
  • Check that live chat is enabled for your inbox

Widget loads slowly​

  • Check that your site isn't blocking third-party scripts
  • Try disabling any ad blockers temporarily