Feedback & ratings


Ratings & Feedbacks is a plugin which helps collect, store, search and track user feedback from web and mobile applications. You need a widget to start collecting feedback from users. Widget is a Countly tool that contains popup and trigger for collect feedback data.

Creating your first widget

As first step, you should create a widget for collect user feedback. Click Feedback Widgets tab in order to access to popups screen.

There is a green button at the top right corner to open widget creator dialog.

How can I find this screen?

You should follow Feedback & Ratings link under Reach menu to access this screen.


The creation process consists of three steps: Popup appearance, Trigger button appearance and Devices & Targeting.


Popup appearance

This section contains inputs for feedback popup appearance like Title of popup, Labels of checkboxes, Title of submit button and Thank you message values. If you leave inputs empty, those values are set as default.

Also you can hide Add comment and Contact me via e-mail sections by use checkboxes on drawer.


Trigger button appearance

This section contains inputs for properties of trigger button. You can customize position of trigger button, background & font color, and trigger button text. Also you can customize trigger buton size, you have three options Small, Medium and Large.

For some use cases which requires manual popup call, there is an option called Hide sticker. If you check this option, even you integrate Feedbacks on your site, popup trigger button won't be seen on the page. Instead, you should call feedback popup manually through show_feedback_popup(widget_id) method. There are sample use cases for this at Integration section, below.


Devices & Targeting

You can easily enable or disable feedback popup for some devices (e.g desktop, tablet or phone) during this step. Also, you can define target pages for which feedback popup can be shown.

You can define exact target pages like /products/our-great-product or use /products/* for all pages under the /products/ path.

By default, feedback popups are disabled. If you want to enable them, just click on Set feedback active checkbox. You may also change feedback popup state after you create it as well.

After this step, our feedback popup is ready to be shown to public.

After creating the popup, a helper page for the web integration will appear. You just need to copy highlighted line and paste into your html file, inside Countly SDK. For details, please check Integration step below.

Edit popup

All feedback popups are listed in a table. If you want to change any configuration about feedback popup, you just need to click Edit popup menu item, as seen below.

When you click on Edit popup in menu, a drawer will appear, as shown below.

As you see above all inputs on every step filled with current values of popup. You can easily change those values and update popup as required.

Removing a popup

When you don't need the a feedback popup anymore, you just need to click on Delete popup under menu at the right corner of the corresponding row.

When you delete the popup, all comments will be removed, so proceed with caution.


When your popup creation process is done, you need to integrate this popup into your application. Ratings plugin can support mobile and web applications, hence we will talk about how to do both integrations, below.

Web Integration

To integrate Ratings to your web application, you first need Countly to integrate web SDK. If Countly web SDK is already initialized on your web application, you just need to integrate one line below (check the line starting with "ATTENTION").


Then your Countly Web SDK integration code section looks like below.

<script type="text/javascript">
// Some default pre init
var Countly = Countly || {};
Countly.q = Countly.q || [];
// Provide your app key that you retrieved from Countly dashboard
Countly.app_key = "1234426e50d669e5035d618cbff9374982065223";
// Provide your server IP or name. Use for EE trial server.
// If you use your own server, make sure you have https enabled if you use
// https below.
Countly.url = "https://your.countly.instance";

// Your Other Countly feature pushes to Countly.q array
// Countly.q.push(['track_session']);
// Countly.q.push(['track_pageview']);


// Load countly script asynchronously
(function() {
var cly = document.createElement('script'); cly.type = 'text/javascript';
cly.async = true;
// Enter url of script here (see below for other option)
cly.src = '/countly.js';
cly.onload = function(){Countly.init()};
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(cly, s);

That's all. You're ready to use Ratings plugin. Please make sure you enable the feedback popup status on dashboard.

Multiple popup

In some cases you may want to use multiple popups in one page. In this case your only need is add popup id values into popups array. For example look code below.


As you see above you can add multiple popup into one page with array type 'popups' parameter of enable feedback function.

Manually calling a popup

You may need to trigger popup manually because of a reason. If you need to trigger popup manually, you should check Hide sticker option on Trigger appearance step of creation process.

After this configuration, you just need to call popup as follows:

var go = confirm("Do you want to continue?");

if (go) {
  // you can get popup id easily throught Copy Popup Id option in popup menu.

Mobile integration

When you use Ratings plugin for mobile applications, you have two options:

  1. Using native dialogs: In this case, native dialogs have the ability to show 1-5 star ratings only.
  2. Using web dialogs: In this case, web dialogs called from native iOS/Android apps can show avatars (faces) that help retrieve end user's feelings (e.g from very satisfied to very disappointed). This is same as how web integration works.

The first case won't retrieve comments but only 1-5 star ratings, whereas second option will be able to show an option to retrieve comments and email of end user.

For iOS integration you can take look at iOS SDK documentation. For Android integration, please check Android SDK documentation.

Was this article helpful?
0 out of 0 found this helpful

Looking for help?