​Trustpilot's improved star rating and TrustScore - Everything you need to know

Get the Convert add-on module to increase onsite conversion with our extensive library of service review TrustBoxes.

Get the module

In early September 2019, Trustpilot rolled out improvements to our star rating and TrustScore across all our products. These exciting changes give both consumers and businesses a more detailed understanding of how companies perform.

Go to Trustpilot Business to see what your star rating and TrustScore look like after this change.

This article walks you through:

  • An overview of the improvements.
  • How the new rating system works.
  • What you need to update yourself and what we update for you.

Overview of the improvements

Introducing half-stars to show a more nuanced star rating

Half-stars are an industry standard, so updating our star rating makes it easier for businesses and consumers to understand how a company is rated. Half-stars also provide a more nuanced, accurate representation of a company’s rating, and helps them see their progress faster.

Updating the TrustScore to 5 points to better correlate with the star rating

Our star rating is displayed as a number of stars between 1 and 5, but our TrustScore has always been displayed as a number between 0 and 10.

Updating our TrustScore to also be calculated and displayed as a number between 1 and 5 makes it easier for companies and consumers alike to understand how a TrustScore relates to the star rating.

How the new rating system works

Your TrustScore is calculated using the same formula as before. We’ve just changed the scale from 0-10 to 1-5.

Using standard mathematical rounding rules, your star rating is rounded up or down to a half or full star, depending on the calculation of your TrustScore.

As before, the three main aspects that go into calculating a company’s TrustScore are:

  • Timespan. The most recent review counts and weighs the most. For example, a review received 6 months ago has half the weight of a review received today.
  • Frequency. Companies need to continuously collect reviews in order to maintain their overall score. For example, a company received twenty 5-star reviews two years ago with a TrustScore of 4.5. If they receive one 1-star review today, their TrustScore would drop to 3.4.
  • Average. We use Bayesian average to ensure that a company with few reviews starts off with a more balanced average TrustScore. For example, if a company receives one 1-star review, its TrustScore would be 3.2.

Updates Trustpilot made for you

We automatically made the following updates for you:

  • Your Trustpilot company profile page and business app automatically switched to the new rating system.
  • TrustBox widgets on your website or in your email marketing automatically switched to use the new rating system.
  • All social sharing features switched to the new rating system: the Image Generator, the one-click share, Facebook page tab, and the Hootsuite app.

Updates to make yourself

From September 2019, you have to update the following manually:

  • Any of your marketing assets (ads, print, TV, etc.) that use your TrustScore, star rating or star label.
  • Any of your API integrations or custom widgets that use your TrustScore, star rating or star label.

Note: If you have not updated your integrations and/or marketing assets, we recommend doing so immediately.

Please contact your Customer Success Manager or our Support Team if you have any additional questions about these improvements.

How to update your API integration to use Trustpilot’s new rating system

Update your API integrations and custom widgets

If you’ve built a custom website integration you’ll need to manually update your on-site implementation. Find the instructions for updating static star images, the Resources API, and the Business Units API below.

Note: Only use our APIs when you want to display dynamic resources on your website, not static resources. Read more about our integration guidelines.

If you use static star images

If you’ve built a custom widget using static images, you can download the latest brand assets from Trustpilot Business.

If you use the Resources API to get Trustpilot’s star image assets or star labels

Half-star image assets and star labels have been added to the Resources API. To access those you can simply call e.g.

https://api.trustpilot.com/v1/resources/images/stars/4.5 or https://api.trustpilot.com/v1/resources/strings/stars/4.5

If you use the Business Units API to get your company’s TrustScore and star rating

Get your company’s TrustScore or star rating from the same "Get public business unit" API endpoint, but use a new key name that points to the new values.

Old response:

"status": "active",
"displayName": "Your company name",
"stars": 5,
"trustScore": 9.2,
"id": "1234567890"

New response:

"status": "active",
"displayName": "Your company name",
"score": {
 "trustScore": 4.6,
 "stars": 4.5
 "id": "1234567890"

No other API endpoints have changed.

Please contact your Customer Success Manager or our Support Team if you have any additional questions about these improvements.