Web widget

One script tag in your page. The widget renders in the shadow DOM — your CSS and its own stay out of each other's way.

Embedding

<script
  src="https://…/widget.js"
  data-project="ts_live_…"
  data-color="#B7F34A"
  data-theme="auto"
  data-label="Feedback"
  async></script>

You will find the key in the project under "Project key".

Attributes

data-project: Required. The public project key.
data-color: Accent colour for the button and submit. Default: #B7F34A.
data-theme: light, dark or auto. Default: auto.
data-label: Label of the launcher. Default: Feedback.
data-launcher: false hides the built-in button — then call Tellstack.open() yourself.

JavaScript interface

// Pass context along (optional, as often as you like)
Tellstack.identify({
  id: 'user_123',
  version: '1.4.2',
  custom: { plan: 'pro', locale: 'de-AT' }
})

// Open it, e.g. from your own button
Tellstack.open()
Tellstack.open({ type: 'bug' })
Tellstack.close()

Everything from identify() ends up in the feedback metadata and is visible in the detail view. Page URL, locale and platform are added by the widget itself.

What the widget does not do

It sets no cookies, tracks no sessions, records no screen content and loads no third-party scripts. It only sends what someone submits in the form, plus the metadata you pass in yourself.

REST API for servers and jobs, hosted forms with nothing to embed.

Get a key

Embedding

Attributes

JavaScript interface

What the widget does not do

Next