Skip to content
Launching soon. These docs describe TellsU as it will be at launch.

Store listings

Stores ask you to say what data your app sends and where. Here’s what TellsU handles, and text to copy for each store.

Nothing is sent until your user clicks Send feedback or a feedback link. That opens TellsU’s feedback page in a new tab, with:

  • your app’s version and the environment details you pass (for WordPress, the WordPress and PHP versions, theme and multisite);
  • the screen: the name of your app’s own page, never an address;
  • the sentiment, if your user clicked a face.

On that page, your user writes their message and can add an email address for a reply. The page detects their browser and operating system, and shows everything that will be sent before they send it. A Cloudflare Turnstile check on the page stops spam.

TellsU doesn’t read browsing history, tabs, page content, cookies or anything else about your users, and uses no advertising or tracking cookies. Under UK and EU GDPR, you’re the controller of the feedback and TellsU is your processor. TellsU’s privacy notice covers the feedback page.

Stores link to your own privacy policy. Add a paragraph like this:

Feedback. When you choose to send feedback, [App] opens a feedback page run by our processor, TellsU (tellsu.com), with [App]’s version and technical details such as your browser and operating system. You see everything that will be sent before sending it. We receive your message, those details, and your email address if you give one, and use them only to answer and improve [App]. Feedback is deleted after [12 months]. See TellsU’s privacy notice at https://tellsu.com/privacy.

Change “12 months” if you’ve chosen a shorter period in your app’s settings.

In your item’s Privacy practices tab:

  • Single purpose and permissions: TellsU needs no permissions, so it adds nothing here.
  • Data usage: feedback is typed and sent by your user on TellsU’s web page, which your extension only opens. If you’d rather disclose it as your extension’s data, the categories that apply are Personally identifiable information (only the email address, when your user gives one) and Personal communications (the message). TellsU touches none of the others: no web history, user activity, website content, location, health, financial or authentication information.
  • Certifications: feedback isn’t sold, isn’t used for anything unrelated to your extension’s purpose, and isn’t used for creditworthiness or lending.
  • Privacy policy: link to yours, with the paragraph above.

The widget sends nothing in the background. Opening the feedback page is the direct result of one click on a button that says Send feedback and Powered by TellsU, which Mozilla’s policy treats as a user-initiated action.

For the listing’s privacy policy field, use your policy with the paragraph above.

New Firefox add-ons declare their data collection in manifest.json. If your add-on otherwise collects nothing, the feedback’s technical details fall under technicalAndInteraction, which Firefox only allows as optional:

"browser_specific_settings": {
"gecko": {
"data_collection_permissions": {
"required": ["none"],
"optional": ["technicalAndInteraction"]
}
}
}

Then pass the version only when your user has allowed it, so the feedback page still works for everyone:

const { data_collection = [] } = await browser.permissions.getAll();
const technical = data_collection.includes('technicalAndInteraction');
TellsU.mount('#feedback', {
appKey: 'pk_yourpublickey', // required; everything else is optional
version: technical ? browser.runtime.getManifest().version : undefined,
screen: technical ? undefined : '',
});

WordPress.org requires plugins to describe external services in their readme. Add a section like this, and keep calling the widget only on your plugin’s own admin pages:

== External services ==
This plugin uses TellsU (https://tellsu.com) to collect feedback from its
users.
On [Plugin]'s admin pages it shows a "Send feedback" button. Nothing is sent
until the button is clicked. Clicking it opens TellsU's feedback page in a
new tab, with the plugin's version, the WordPress and PHP versions, the
active theme's name, whether the site is a multisite, and the admin page's
name. On that page you can write a message and, if you want a reply, an
email address. The page detects your browser and operating system, and
shows everything that will be sent before you send it.
The feedback goes to [Plugin]'s developer through TellsU. TellsU uses no
advertising or tracking cookies and reads nothing else about your site or
its visitors.
TellsU's terms: https://tellsu.com/terms
TellsU's privacy notice: https://tellsu.com/privacy