Skip to main content

Reviews

In the JetShip Next.js SaaS Starter Kit, the Reviews section allows admins and users with appropriate permissions to manage customer reviews and review platforms through the admin interface at /admin/reviews. These reviews can be showcased on the front end to help build customer trust through testimonials.

This documentation explains how to manage review platforms, individual reviews, and how these resources are presented to users on the front end.

Storage

Reviews and platforms are stored in the database, ensuring efficient querying and real-time updates.

🛠 Review Platforms and Reviews​

Admins and users with the necessary permissions have full control over creating and managing reviews and platforms. The review management tools are divided into:

  • Review Platforms – Organize and manage different platforms where reviews are sourced from (e.g., Google, Trustpilot).
  • Reviews – Create and manage individual review entries, including ratings, content, and platform assignments.

These tools enable authorized users to manage content that will be displayed on the front-end review/testimonials section.

🔑 Accessing Reviews​

To manage reviews, follow the steps below depending on your user role:

  1. Admin: Navigate to the Reviews section in the admin panel.
  2. Authorized User: If you have the necessary permissions (create_reviews, update_reviews, view_reviews), you can manage reviews via the user interface.

The Reviews section contains two main options for managing reviews:

  • Platform: Used to create, edit, and organize review platforms.
  • Review: Used to create, edit, and manage individual review entries.

📂 Managing Review Platforms​

Platforms help organize and categorize reviews based on their source. Here's how you can manage them:

Creating a New Platform​

  1. Navigate to Reviews > Platform in the admin panel or user interface (if you have the necessary permissions).
  2. Click on the New Review Platform button.

In the Create Review Platform form, complete the following fields:

  • Platform Name (required): A descriptive name for the platform (e.g., "Google Reviews", "Trustpilot").
  • Platform Image: Upload a logo image to visually represent the platform.
  • Platform Slug: A unique identifier for the platform, automatically generated from the name.

After filling in the details, click Create to save the platform or Create & Create Another to add a new platform.

tip

Choose easily recognizable platform names and upload high-quality logos to maintain professionalism in your reviews section.

📋 Managing Individual Reviews​

This section allows you to create and manage individual customer reviews. Each review can be linked to a platform and optionally marked as featured.

Creating a New Review​

  1. Navigate to Reviews > Review in the admin panel or user interface (if you have the necessary permissions).
  2. Click on the Add New Review button.

In the Create Review form, fill in the following fields:

  • Review Title (optional): Enter a title for the review if necessary.
  • Review Platform (optional): Select the platform where the review originated.
  • Review Link (required): Provide a URL to the original review.
  • Review Video URL (optional): Add a video testimonial URL if available.
  • Ratings (optional): Set the review rating (defaults to 5 stars).
  • Review Text (required): Enter the review text/testimonial.
  • Is Featured (optional): Toggle to mark the review as featured for prioritization on the front end.
  • Reviewer Name (required): Name of the reviewer.
  • Reviewer Designation (optional): The reviewer's job title or role (e.g., "CEO", "CTO").
  • Reviewer Location (optional): Reviewer's country (e.g., "US", "UK").
  • Reviewer Image: Upload an image associated with the reviewer (e.g., reviewer's photo).

Once you’ve filled in the details, click Create to save the review, or Create & Create Another to continue adding reviews.

info

Ensure the content is authentic and properly formatted to guarantee the best presentation on the front end.

🌟 Featured Reviews​

Marking a review as Featured will prioritize it on the front end, making it more visible to visitors. This is helpful for showcasing particularly positive or impactful testimonials.

Steps to Feature a Review:​

  1. Edit the review in the admin panel.
  2. Toggle the Is Featured option.
  3. Save the changes.

Featured reviews may appear in prominent locations, such as:

  • Homepage testimonials section.
  • Dedicated reviews/testimonials page.
  • Product/service pages.

🔍 Reviews on the Front-end Component​

On the front end, users can view reviews categorized by platform and featured status. The reviews component dynamically pulls data from the database and displays it in an engaging format. Visitors can:

  • View Featured Reviews: Featured reviews may appear in prominent sections or at the top of the review list.
  • See Ratings: Star ratings provide quick visual feedback on customer satisfaction.
  • Read Detailed Testimonials: View the full review content, including reviewer details and the review text.
tip

For more diverse social proof, mix text reviews with video testimonials, if available.

🔄 Updating Front-end Review Content​

Once reviews are updated in the admin panel or by authorized users, these changes are automatically reflected on the front end. There is no need for additional steps to sync content. Updates to reviews, such as featured status, ratings, or review text, are instantly visible on the front-end reviews section.