Widget Configuration Reference

Explore the complete reference of script loader parameters, HTML attributes, and site configuration options.

Last updated:2026-07-11

The TellBack widget is configured by setting attributes on the loader <script> tag and defining site properties inside the dashboard settings.

---

Script Tag Attributes

Include these attributes directly on the script loader to configure client execution:

• data-tellback-site (Required): The public key identifying your site.
• data-tellback-verification (Optional): The verification token used during onboarding setup.
• data-tellback-endpoint (Optional): A custom API endpoint URL for self-hosted instances.
• data-tellback-dev-mode (Optional): Enables debug logs in the browser console when set to "true".

---

DOM Attributes

Add these attributes to HTML elements inside your page markup to control screenshot capturing and telemetry:

• data-tellback-ignore: Removes the matching element and all its children from screenshot clones and telemetry event tracking.
• data-tellback-mask: Blurs or masks the element's text content inside screenshots and replayed sessions.
• data-tellback-label: Custom identifier label reported in task descriptions for element clicks or form bookings.

---

Dashboard Configuration Parameters

These parameters are fetched dynamically from the TellBack backend when the widget initializes:

• feedbackMode: Controls widget UI and session tracking behaviors:
  • collect_nothing (Off)
  • pageviews_only (Feedback Links + pageviews)
  • sessions_hidden_widget (Silent context + Feedback Links)
  • full_feedback_mode (Public feedback widget)
• identityMode: Manages visitor identification requirements:
  • optional
  • required
  • anonymous

---

JavaScript API Status

[!IMPORTANT] TellBack does not currently expose a public JavaScript API on window. All operations, styles injection, event listeners, and uploads are handled automatically inside the self-contained script bundle.

---