Tellback
Book Demo

Quickstart: Get Feedback in 5 Minutes

Install the TellBack widget on your website and receive your first context-rich feedback card in under 5 minutes.

Last updated:

Welcome to TellBack! This quickstart guide walks you through setting up a project, installing the widget script, and submitting your first tester bug report.

Have an existing client invite link? Go to /onboarding to join your team's workspace immediately.

Prerequisites

Before starting, ensure you have:

  • A TellBack dashboard account.
  • Access to your website's source code.
  • Your project's public key (found in Project Settings).

Step-by-Step Setup

Step 1: Create a Project and Site

Log in to the TellBack dashboard and click Create Project. Under Project Settings, create a new Site representing your environment (e.g., Staging or Production).

Each Site is assigned a unique Public Key.

Step 2: Install the Widget Code

Place the following script tag immediately before the closing </body> tag on your website:

html
<!-- Add this to your HTML file -->
<script async
  src="https://tellback.io/widget.js"
  data-tellback-site="YOUR_SITE_PUBLIC_KEY"
></script>

Step 3: Configure Allowed Origins

For security, the widget will not initialize on domains that aren't explicit allowed. Navigate to your site dashboard Settings > Sites, and add your host domain under Allowed Origins.

For local testing, always include http://localhost:3000 or the exact local address of your development server.

Step 4: Submit a Test Feedback

Open your website in the browser. You should see the floating TellBack widget button on the screen.

  1. Click the button to open the widget card.
  2. Select an element on the screen using the element picker.
  3. Write a text note describing a bug or feedback.
  4. Click Submit.

Once submitted, the feedback, automatic masked screenshot, click timeline, and browser context will immediately appear in your dashboard inbox!

Core Feature Behaviors

Request Demo Feature

Feedback mode controls feedback/session behavior. Request Demo is controlled separately. Setting your Feedback Mode to collect_nothing (Off) but keeping Request Demo enabled will load a Request Demo-only widget on the client, performing a sessionless booking flow with no background tracking.

AI Task generation

Project AI settings control whether screenshots, audio/transcripts, and session context are included in AI task generation.

Privacy Responsibility
Site owners are responsible for providing appropriate visitor notices and obtaining any required consent for feedback collection, session tracking, replay, audio, screenshots, and AI processing.

Next Steps