Skip to main content

Use page ratings and feedback (SAP KC)

Why is feedback important?

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.

Page rating

Page ratings will appear on articles with the following classification article types:

  1. Topic
  2. How-To
  3. Reference

Feedback will appear at the bottom of an article:


Article feedback

  • The feedback form will expand after clicking Yes or No.  If a user does not want to submit any feedback they can select Leave Feedback and the feedback form will expand. A user does not need to leave feedback for the page rating to stand.
  • After rating a page you will see the date you rated the page to reference in the future. An example would be if a user went back to a page after the article was updated with the information they were looking for and they wanted to switch their page rating from No to Yes.
  • Users can also click the checkbox below the feedback content area to choose whether or not they would like to be contacted regarding the article's feedback.


Setting up default email

Site Administrators can create an email address for all article feedback through the  MindTouch Control Panel. To have article feedback be sent out to multiple users we recommend you set up a group email through your email provider. You can locate the email setting at the Configuration page under System Settings.


Showing feedback with custom Article Types

If you have custom article types and would like Article Feedback to appear on them, you will need to add some custom CSS in your Control Panel. For more information about custom classifications please read create custom classifications.

Find custom Article Type class name

Find the class name used for your custom Article type.  Custom Article types will 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> is "faq". To see the <HTML> of your page, you can right click, then "View Page Source" in most browsers.



If you are unsure of what the class name should be for your custom Article type, then navigate to your global variables template and look for the tag value.


Add custom CSS to Control Panel

Once you have the class name for your Article type, navigate to the Custom CSS settings located in the Control Panel. Add the following CSS for Article Feedback to appear.

.faq .mt-feedback-rating-container {
    display: block;

Your custom Article type will now display Article Feedback.

What's next?

Site Administrators can learn more about the MindTouch Community Scoring Report.  In order to better understand feedback throughout their site.