Trustpilot's TrustBoxes - FAQ

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

Get the module

Get answers to some of the most common questions about displaying, loading, implementing, and the availability of Trustpilot's TrustBoxes.


I'm on a free account. Are there any TrustBoxes I can use on my website?

Yes! With Trustpilot’s Free plan, you have access to two TrustBoxes: Micro Review Count and Review Collector.

I've implemented the TrustBox script for the Carousel widget, but it only displays the Trustpilot logo or the number of reviews I have. Why doesn't it show the Carousel TrustBox?

Depending on your pricing plan, you can use the Carousel TrustBox. If you're a free customer, you don't have access to the Carousel.

I'd like to have a TrustBox where consumers can leave a review directly on the website. Do you have one?

Yes! The Evaluate TrustBox allows customers to review you directly on your website.

Security and Compliance

What data do TrustBoxes track?

TrustBoxes track three anonymised events related to the widget:  impressions, views, and clicks. These events help you understand how the widget is performing on your business's website. TrustBoxes do not track any individual user information. 

Do TrustBoxes set cookies?

No. TrustBox widgets do not set cookies, unless you are running an A/B split test using the TrustBox Optimizer tool. The TrustBox Optimizer sets two cookies during a split test, to track the conversion of each widget test variation. These cookies contain an anonymised id of the user, and an indicator of which variation the user viewed. This allows the tool to provide the conversion rate for each widget variation, to determine which widget performs best. Once the split test is concluded, the cookies are automatically removed.

Do TrustBoxes support Subresource Integrity (SRI)?

No. Because enforcing an SRI hash would require you to update your website in sync with Trustpilot's frequent updates to ensure your widgets still work.

Payment Card Industry Data Security Standard (PCI DSS) Compliance regulations do not apply to our widgets because Trustpilot does not accept, process, store, or transmit card payment information. It's a recommended practice for PCI DSS Compliant customers to segregate PCI DSS compliant needs from other web components, and safeguard according to their respective unique business responsibilities.

Loading issues

Why doesn't my TrustBox load properly? It only shows a link to Trustpilot.

It sounds like the bootstrap script hasn't loaded. The bootstrap script is the first of the two code snippets you need in order to embed a TrustBox on your page.

We recommend placing the script in the <head></head> section of your website’s HTML. If you don't have access to that, place it in the <body></body> section just before the TrustBox code (the second code snippet). We also have a guide to help you make sure your TrustBox has been correctly implemented, and if it runs in a single-page application.

Note: You may encounter problems loading your TrustBox in Internet Explorer 11 if your page is configured to run in Internet Explorer 9 compatibility mode. To check, search for a <meta http-equiv="X-UA-Compatible" content="IE=9"> tag in the head section of your page. If it's there, your page is configured incorrectly, so simply remove the tag.

What happens to my TrustBox if Trustpilot's systems are down?

TrustBoxes have an extra layer of fallback cache (30 days), so your TrustBox will continue to show review content. However, review data won't be updated every 20 minutes until the error has been solved. If the fallback cache is down or has expired, TrustBoxes display a fallback logo.

Can adblockers block the TrustBox from displaying reviews?

It depends on the adblocker. Adblockers block a wide range of things and aren't all the same, so we can't guarantee that all adblockers allow all TrustBoxes to display reviews. That said, we monitor our TrustBoxes to keep this from being a problem.

What browsers are compatible with TrustBoxes?

Trustpilot supports Chrome, Firefox, Safari, and Edge. TrustBoxes are not compatible with Safari for Windows, and Internet Explorer v. 10 and earlier.

Note: TrustBoxes display properly in newer versions of Safari on Mac OS, but you may experience some issues with older versions of Safari.

Implementation questions

How do I add a TrustBox to my website?

Once you've picked out a TrustBox and configured it in Trustpilot Business, you need to add some code to your website. Here's a step-by-step guide and a video that shows you how to get your TrustBox up and running.

How can I optimize my marketing campaigns with the TrustBox widgets?

With TrustBox Signature and TrustBox Newsletter you can share your reviews and your TrustScore with customers in your newsletters.

Can I implement a TrustBox on my WordPress website?

Yes. You need to add the bootstrap script into the header of the display page, so you'll need to change your WordPress header.php template file. You may need help from a developer to do this. You may also switch from Visual to Text edit mode in WordPress, then paste the TrustBox JavaScript and HTML code snippets into the editor.

I don't see any products in the Product Review TrustBox I just installed. How do we create them and link them to the TrustBox?

Make sure you've created your product catalog correctly. 

My rich snippet stars have disappeared from Google. Why did this happen and what can I do to get them back?

Rich snippet stars appear at Google's discretion. Make sure you thoroughly check your website to improve the likelihood that you'll get those stars back.

Important: On September 16, 2019, Google changed their rich snippet guidelines. Here’s some information about what this means for Trustpilot’s customers and community.

Will a TrustBox slow down my website and does it affect SEO?

TrustBoxes are designed to have minimal impact on your website. When your page loads for the first time following implementation, you’ll get a request to load a small script. The small script doesn't fetch the TrustBox content until your page has loaded. TrustBoxes wait for your website to load fully to minimize impact. If your page loads slowly, Google may not index your page and that might affect your SEO.

Display issues

How do I change my TrustBox's language?

There are two things you need to do to change your TrustBox's language. First, you can change the display language. This only changes the language of the widget itself, not the reviews.

  1. In Trustpilot Business > Showcase > Website widgets > TrustBox library, choose your TrustBox.
  2. Under Get your TrustBox, go to Configure your TrustBox.
  3. In the Widget language drop-down menu, choose your language and then click Get code.

Secondly, if you have chosen a TrustBox that displays reviews, you can filter the reviews to only show those written in your preferred language. Once you've followed the steps above, continue: 

  1. On the widget you'd like to change, under the Widget language drop-down menu, ensure the toggle Only select reviews written in this language is on. This is the default setting.
  2. You can also switch the toggle off to display reviews written in all languages.

Can I change the color of my TrustBox?

With the appropriate pricing plan, you can change the font color of TrustBoxes that display service reviews. You can also change the star color of TrustBoxes that display product reviews.

Do TrustBoxes use responsive design?

Absolutely. All our TrustBoxes are responsive. They have internal breakpoints that ensure the content position adapts to given dimensions and they can scroll.

TrustBoxes are embedded in an iFrame on your website. The iFrame doesn't fully support resizing, so TrustBoxes aren't completely fluid in all dimensions. When you resize your browser window, the TrustBox's width resizes, but the height remains fixed. For the best results, set the width to 100% and adjust the height of your DOM elements to fit the TrustBox's minimum height.

Note: Check the minimum and maximum dimensions of your TrustBox(es) before implementing them. You'll find this information on the Preview page of each TrustBox.

How do I show review data on mobile using a TrustBox Carousel?

Create a responsive state by overriding the height of the iFrame to be larger on mobile. You can wrap the TrustBox with a new HTML division and override the iFrame's height with CSS.

See example:

<div class="carousel">
<!-- TrustBox widget -->
<div class="trustpilot-widget" data-locale="en-GB" data-template-id="53aa8912dec7e10d38f59f36" data-businessunit-id="5400267300006400057a0113" data-style-height="130px" data-style-width="100%" data-theme="light" data-group="on" data-stars="1,2,3,4,5">
<a href="" target="_blank">Trustpilot</a>
<!-- End TrustBox widget -->
/* Target mobile displays with a media query */
@media (max-width: ...) {
  .carousel {
width: 320px;
  .carousel iframe {
height: 280px !important;