Skip to main content

Use page ratings and feedback (MT4)

Why is feedback important?

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

Page ratings

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

  1. Topic
  2. How-To
  3. Reference



Article feedback

Feedback appears at the bottom of an article:

  • The feedback form expands after clicking Yes or No. If users want to submit any feedback, they can click the Leave Feedback link to expand the feedback form.

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. Locate the email setting on 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 our article on how to 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, navigate to your control panel and view your classifications 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 to better understand feedback throughout their site.

  • Was this article helpful?