UpStart Commerce Services
Ratings

Configuration

6min

The Configuration section within the Ratings & Reviews service enables you to customize the display and management of ratings and reviews on your website. This section allows you to control settings such as moderation requirements, email notifications, and rating scales. This guide provides comprehensive instructions to help you manage your ratings and reviews effectively.

Prerequisites for First-Time Integration of Ratings & Reviews

If you’re setting up the Ratings & Reviews service for the first time, follow the steps below to ensure seamless integration with your existing systems.

  • Up-to-date Product Catalog: First, verify that your system meets the technical requirements for integrating the Ratings & Reviews (R&R) feature. Ensure that your product catalog is up-to-date and accessible in the portal.
  • Initial Setup: The Ratings & Reviews service will be immediately available once your new tenant is set up. For instructions on creating a new tenant, please refer to the Sandbox Account Acquisition guide. For optimal performance, it is recommended to complete all configuration steps before integrating ratings into your product listings.

Configure the Rating Scale

When configuring the rating scale, retailers can choose from a variety of options. Here’s how to approach it:

A Rating Scale is used to quantify customer sentiment, preferences, or experiences regarding a product, service, or any other measurable attribute. 

For example, common scales include:

  • Likert Scale (e.g., 1-5, from strongly disagree to strongly agree)
  • Numerical Rating (e.g., 1-10 scale)
  • Star Ratings (e.g., 1-5 stars)

Each type of scale offers a structured way to measure sentiment in a manner that is easy to interpret and act upon. Now after understanding this, you can decide the appropriate rating scale for your business.

Note: The rating scale is statically configured and must be set manually through the GQL API, as changes cannot be made from the front end. Ensure that the rating scale is configured manually first.

After the above steps proceed with the steps below to configure UpStart Comm Ratings and Reviews according to your business requirements.

Step 1: Access Configurations

Upon logging in to the UpStart Commerce Portal, navigate to the side menu. Select Ratings, then click Configurations. Here, you can view the configuration options.

Document image


Step 2: Configure Settings

Fill in the information for each of the following fields:

  1. Label:
    • The label is a description that appears as part of your Ratings section on the website. Ensure that the label is clear and descriptive to provide context to users.
  2. Moderation Required:
    • This checkbox needs to be checked if you want customer reviews to be part of the pending reviews list before being published. Leave the box unchecked if the review does not require moderation and should be published immediately as an accepted review.
  3. Email New Moderations:
    • Check this box to receive an email notification when new reviews or ratings are submitted.
  4. Contacts List:
    • This is the list of people notified via email upon new reviews/ratings. To maintain effective communication, ensure that this list is updated with relevant contacts.
  5. Ratings Per User:
    • This setting defines the number of times a user can review a product. Specify a reasonable limit to avoid spam and ensure genuine feedback.
  6. Sharing Across Sites:
    • Check this box to share the review across all available sites. If you prefer to share data across specific sites, specify the site names in the provided section.
  7. Employee Domains: Add the respective employee domains to differentiate between employee and customer reviews, e.g., upstart.com, and shopify.com.
  8. Rating Scale:
    • Maximum Rating Number:
      This is the highest number of ratings a user can give. For example, if set to 5, users can rate from 1 to 5 stars.
    • Minimum Rating Step:
      This defines the increment steps for ratings. For example, if the minimum rating step is 1, the ratings will be 1, 2, 3, 4, and 5. If set to 0.5, the ratings will be 0.5, 1, 1.5, 2, 2.5, and so on.

Note: The rating scale is statically configured and can be adjusted through the GQL API manually, as changes cannot be made from the front end.

Document image