Feedback form for browser extensions

Add a feedback form to your Chrome, Edge or Firefox extension. The widget goes in any of your extension’s own pages: a popup, an options page, a side panel. It’s bundled into your extension, never loaded from TellsU, and it needs no new permissions. Nothing is sent until someone clicks it.

Your app’s Installation tab in the TellsU dashboard has each snippet below with your public key filled in; the examples here use pk_yourpublickey in its place.

Add the widget

npm

For extensions with a build step.

1. Install the package:

   npm install @tellsu/widget

2. Add an element where the widget should appear, in whichever page should show it:

   <div id="feedback"></div>

3. Mount the widget in a script that page runs. The version comes from your manifest:

   import { TellsU } from '@tellsu/widget';
   
   TellsU.mount('#feedback', {
     appKey: 'pk_yourpublickey', // required; everything else is optional
     version: chrome.runtime.getManifest().version,
   });

React

For extension pages built with React.

1. Install the package:

   npm install @tellsu/react

2. Add the component:

   import { TellsUWidget } from '@tellsu/react';
   
   export function Feedback() {
     return (
       <TellsUWidget appKey="pk_yourpublickey" version={chrome.runtime.getManifest().version} />
     );
   }

3. Render <Feedback /> where the widget should appear.

The props are the widget’s options, plus className for the element it mounts into. It mounts once, even under StrictMode, and remounts only when an option’s value changes, so passing a new env object on each render is fine.

Without a build step

1. Download tellsu.min.js from the Installation tab and put it anywhere in your extension. The tab shows its version and a SHA-384 checksum to compare with shasum -a 384 tellsu.min.js.

2. In the page’s HTML, add an element for the widget, then the file, then your page’s own script:

   <div id="feedback"></div>
   <script src="tellsu.min.js"></script>
   <script src="popup.js"></script>

3. Mount the widget in that script file. Manifest V3 doesn’t run inline scripts, so it can’t go in the HTML itself:

   TellsU.mount('#feedback', {
     appKey: 'pk_yourpublickey', // required; everything else is optional
     version: chrome.runtime.getManifest().version,
   });

What’s sent

The widget opens TellsU’s hosted page in a new tab with:

• your extension’s version;
• the screen: the page’s file name without .html, such as popup or options (set the screen option to name it yourself);
• the sentiment, if a face was clicked.

The hosted page detects the browser and operating system itself. Because it opens in the same browser, that’s the browser your extension runs in. Nothing about the tabs, sites or pages your users visit is read or sent.

You can add a release channel and edition, and on the paid plan, values of your own. See the widget’s options.

Before you publish

Add TellsU to your store listing’s privacy details: see Store listings for the Chrome Web Store and Firefox add-ons.