Documentation

Search documentation

Search guides, setup steps, troubleshooting, and product checklists.

Widget7 min readUpdated May 5, 2026

Install the widget

Install the customer-facing widget with a script tag and organization ID.

The widget is installed with a hosted JavaScript bundle. The organization ID tells the widget which workspace should receive conversations and load theme settings.

Basic snippet

html
<script
  src="https://staging-widget.tinfiz.com/widget.js"
  data-org-id="YOUR_ORGANIZATION_ID"
  async
></script>

Where to place it

  • Static website: place the script before the closing body tag.
  • Next.js or React app: load the script once in the root layout or app shell.
  • CMS or no-code platform: use the global custom code area when available.
  • Tag manager: use a Custom HTML tag triggered on all pages after consent rules are handled.

Verify installation

Steps
  1. 1Open the website in a private browser window.
  2. 2Confirm the launcher appears in bottom-left or bottom-right position.
  3. 3Send a test message from the widget.
  4. 4Open inbox and confirm the conversation appears in realtime.
  5. 5Reply from inbox and confirm the visitor sees the reply without refreshing.