Skip to main content

Use article ratings and feedback

This page applies to:MindTouch Responsive

Receiving feedback from your community around an article's helpfulness through page rating and feedback will help improve the quality of your documentation. Positive ratings will raise the article in search results for valid queries. Negative ratings will work similarly but in the opposite fashion.  Article feedback will also increase dialog between client and business and provide valuable information on an article's helpfulness.


Article rating

Article rating will provide you with good insight as to how your articles are being perceived by your community on a global level. It's as simple as your users being able to let you know, "Yes this article helped me find what I need." or, "No, I wasn't able to solve my problem with this article." After rating a page users will see the date they rated the page to reference in the future. If a user went back to a page after the article was updated with the information they were initially looking for and they now wanted to switch the page rating from No to Yes, the user can do so. Administrators can enable/disable rating for your anonymous users via the control panel configurations.


Article feedback

Once a user clicks Yes (smiley face) or No (frowny face), the feedback form at the bottom of an article expands, allowing users to provide additional feedback on the article. Users who only want to leave feedback, can do so by just clicking Leave Feedback. Users can select whether or not they would like to be contacted regarding their feedback.

  NOTE:  A user does not need to leave feedback for the article rating to stand.


Set up your default feedback email

Site administrators can specify an email address for article feedback through the MindTouch control panel:

  1. From the MindTouch toolbar, select Site tools > Control panel.


  1. Click Configuration under System Settings.


  1. Enter your Email Address for User Feedback and click Save.

  TIP:   To have article feedback sent out to multiple users, we recommend setting up a group email through your email provider.


Allow feedback for your custom article types

If you have custom article types (read more about custom classifications here) and would like article feedback to appear for your custom articles, you will need to add some custom CSS in your control panel:

Find the class name of your custom article type

Custom article types inject a class name to the <body>tag of each page they occur on. For example, if you have an article type set to "FAQ," the class name injected into the <body> isfaq.  In most browsers, to view page elements, right-click anywhere on your page and select Inspect:


If you are unsure of the class name for your custom article type, navigate to Control panel > System SettingsClassifications and look for the tag value.


Add custom CSS to the control panel
  1. Once you have the class name for your article type, navigate to Control panelBrandingCustom Site CSS.
  2. Add the following CSS (replace faq with your article type class name) and click Save:
.columbia-article-faq .mt-feedback-rating-container {
    display: block;

What's next?

Site administrators can learn more about the MindTouch community scoring report in order to better understand feedback throughout their site.

  • Was this article helpful?