Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tinyinbox.co/llms.txt

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

​
The widget does not appear

Check the script tag first:
  • The src points to your TinyInbox widget script.
  • The data-tinyinbox-site value matches the site key from your dashboard.
  • The snippet is on the page before the closing </body> tag.
  • Your site builder is allowed to load third-party scripts.

​
Messages do not reach the inbox

Make sure the site domain in TinyInbox matches the page where you installed the widget. If the dashboard site is set to example.com, install the widget on example.com or an allowed matching host. Also check that the visitor can reach the TinyInbox API from the browser. Browser extensions, strict content security policies, or blocked scripts can prevent the widget from sending messages.

​
Visitor names or emails are missing

Browser-provided visitor details are optional. If you want TinyInbox to trust the visitor ID, name, or email for logged-in users, use identity verification.

​
Identity verification fails

Check that the token:
  • Is signed with the current site identity secret
  • Uses HS256
  • Sets the audience to tinyinbox-widget-identity
  • Includes userId or sub
  • Has not expired
If the secret was exposed, rotate it in the dashboard and update your backend environment variable.