Skip to main content

Overview

The Reviews & Ratings system is essential for building trust and reputation on Khedma Market. After completing an order, clients can leave reviews and ratings that appear on both the freelancer’s profile and the specific gig. These reviews help future clients make informed decisions and incentivize high-quality work.

Key Capabilities

Review Components

Star Ratings

Numerical rating from 1-5 stars indicating satisfaction level

Written Comments

Detailed feedback about the experience and deliverables

Gig-Specific

Reviews are tied to specific gigs and appear on gig pages

Profile Aggregation

Overall freelancer rating calculated from all reviews

Rating Impact

Reviews influence multiple aspects of the platform:
  • Search Rankings: Higher-rated gigs appear more prominently
  • Client Decisions: Reviews help clients choose freelancers
  • Freelancer Reputation: Builds credibility and trust
  • Gig Visibility: Well-reviewed gigs get better exposure
  • Profile Showcase: Overall rating displayed on freelancer profiles

User Workflows

For Clients: Leaving a Review

1

Complete an Order

Reviews can only be left after an order reaches Completed status. This ensures reviews reflect actual work experience.
2

Access Review Form

Navigate to the completed order or receive a review request notification. Click “Leave Review” or “Rate Order.”
3

Rate the Experience

Select a star rating from 1 to 5:
  • 5 stars: Excellent, exceeded expectations
  • 4 stars: Good, met expectations
  • 3 stars: Average, acceptable work
  • 2 stars: Below expectations, issues present
  • 1 star: Poor, significant problems
4

Write Your Feedback

Provide detailed comments about:
  • Quality of deliverables
  • Communication and professionalism
  • Timeliness of delivery
  • Value for money
  • Any issues or outstanding aspects
5

Submit Review

Publish your review. It appears immediately on the gig page and contributes to the freelancer’s overall rating.
Be honest and constructive. Reviews help the community and give freelancers valuable feedback for improvement.

For Freelancers: Managing Reviews

When clients leave reviews:
  • Receive notification of new review
  • Review appears on your profile and gig page
  • Overall rating is automatically updated
  • Review influences gig rankings
You cannot edit or delete client reviews, maintaining authenticity.

Rating Calculation

Freelancer Overall Rating

The overall rating displayed on a freelancer’s profile is calculated as:
Overall Rating = Sum of all ratings / Number of reviews
Example:
  • Review 1: 5 stars
  • Review 2: 4 stars
  • Review 3: 5 stars
  • Review 4: 4 stars
Overall Rating = (5 + 4 + 5 + 4) / 4 = 4.5 stars

Gig-Specific Ratings

Each gig can have its own rating based on reviews for that specific service:
Gig Rating = Sum of gig's review ratings / Number of reviews for that gig
This allows freelancers to see which services are most successful.

Important Fields

Review Model

id
string
Unique review identifier
rating
integer
required
Star rating from 1-5
comment
string
required
Written review feedback
gigId
string
Gig being reviewed
userId
string
Client who wrote the review
createdAt
datetime
When the review was posted
updatedAt
datetime
Last modification timestamp

Review Display

Reviews appear in multiple locations:
All reviews for a specific gig are displayed, showing:
  • Reviewer name and profile picture
  • Star rating
  • Written comment
  • Date posted
  • Most recent reviews appear first
The profile shows:
  • Overall average rating (e.g., 4.8 stars)
  • Total number of reviews
  • Recent reviews across all gigs
  • Rating breakdown if implemented
Gig listings display:
  • Star rating badge
  • Number of reviews
  • Helps clients filter by quality

Review Guidelines

For Clients Writing Reviews

Write honest, professional reviews. Abusive, false, or malicious reviews may be removed and can result in account penalties.
Good Review Practices:
  • Be specific about what you liked or didn’t like
  • Focus on the work quality and experience
  • Provide constructive feedback
  • Be fair and honest
  • Mention standout positives
  • Explain any negatives clearly
Avoid:
  • Personal attacks or insults
  • Threats or intimidation
  • Irrelevant information
  • Reviews unrelated to the actual service
  • Extreme reactions for minor issues

For Freelancers Responding to Reviews

While you cannot edit client reviews, you can respond professionally through messaging or public responses (if the feature is implemented).
How to Handle Negative Reviews:
  • Thank the client for feedback
  • Address specific concerns professionally
  • Offer solutions or explanations
  • Learn and improve from criticism
  • Don’t argue or become defensive
  • Use it as an opportunity to show professionalism

Rating Tiers & Meanings

5 Stars - Exceptional

Outstanding work that exceeded expectations. Highly recommended.

4 Stars - Great

High-quality work that met expectations. Would work with again.

3 Stars - Good

Acceptable work with room for improvement. Met basic requirements.

2-1 Stars - Poor

Significant issues or unmet expectations. Major improvements needed.

Building Your Reputation

1

Start Strong

Your first few reviews set expectations. Deliver exceptional work on early orders to build momentum.
2

Maintain Quality

Consistency is key. Every order should meet your quality standards to maintain high ratings.
3

Encourage Reviews

After successful delivery, politely remind clients to leave reviews if they’re satisfied.
4

Learn from Feedback

Use lower ratings as learning opportunities. Identify patterns and make improvements.
5

Scale Gradually

Don’t take on more work than you can handle. Quality over quantity protects your rating.

Orders & Payments

Complete orders to receive reviews

Freelancer Profiles

Reviews appear on your profile

Gig Marketplace

Reviews displayed on gig pages

Messaging

Address concerns before they become negative reviews
A strong review profile with 4.5+ stars and multiple reviews can dramatically increase your order volume and allow you to charge premium prices.

Build docs developers (and LLMs) love