Trustpilot's TrustBox widgets - FAQ


When your existing customers are talking about you, your potential customers are listening.

Start collecting reviews today!

Get answers to common questions about Trustpilot's TrustBox widgets - Implementation, loading time, supported browsers, tracking, SEO, and much more.

How often do TrustBoxes update?

Review data is updated every 20 minutes.

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 will show a fallback logo.

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

Check that you've implemented the script correctly on the page. We recommend placing the script in the <head></head> section of your website’s HTML, and if you don't have access to that, place it in the <body></body> section just before the div. If you're using a single page app, you can get more details here.

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 of your page. If it's there, your page is configured incorrectly, so simply remove the tag.

How do I change the language of the TrustBox?

The language can be changed by configuring the data-locale variable. Select this variable in the configuration section for each TrustBox.

What are the supported browsers for TrustBoxes?

TrustBoxes are built to work in all modern browsers: Chrome, Firefox, Safari (iOS), Edge, Opera and Internet Explorer (v.11 and newer).

The following browsers do not support TrustBoxes: Safari for Windows, IE10 and older.

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

Will a TrustBox slow down my website, and 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 won’t fetch the TrustBox content until your page has loaded.

TrustBoxes wait for your website to load fully to minimize impact. So if your page is extremely slow, Google may not index your page, and that might affect your SEO. Page speed is one of many factors affecting SEO. As long as your page load is not extremely slow, there’s no need to worry about it.

What does Trustpilot track in TrustBoxes?

Trustpilot uses impression tracking to check how many times a TrustBox is loaded. We also use speed performance tracking to track how fast a TrustBox loads. Then, we use the tracking data to monitor and improve the TrustBox’s performance on a continuous basis.

To enable geographic performance analysis, we transform the IP addresses tracked to geographic country data, and we store this data in our systems. We do not store the IP addresses themselves.

Can I put a TrustBox inside my own Android or iOS application?

You can put a TrustBox widget inside an app built on Android or iOS by using a web view. Alternatively, you can build your own custom TrustBox widget using our APIs.

Can I implement a TrustBox with a system that uses XML as its document type?

Yes. However, it’s important to note that when using a CMS or other system that uses XML as its document type, the TrustBox script code snippet needs to change. In the TrustBox snippet that we provide, there's a property called `async`. To be compliant with the XML specification, simply change `async` to `async="async"`.

Can I show a TrustBox in a pop-up?

TrustBoxes utilize an API. Some TrustBoxes can open as a pop-up or in a new window, depending on the web developer’s particular implementation of it. There are also two TrustBoxes in the TrustBox Library with pop-up functionality: the Pop-Up and the Drop-Down. Both take up minimal real estate on the web page, but expand upon clicking.

Can I show a TrustBox floating in the corner of my web page?

If you use a container, you can position the TrustBox wherever you'd like. Reach out to your developer for assistance.

Can I implement a TrustBox on my WordPress website?

Yes. Add the TrustBox JavaScript code snippet into the header of the display page. As this requires changing your WordPress header.php template file, you may need help from a developer.

You may also switch from Visual to Text edit mode in WordPress, then paste the TrustBox JavaScript and HTML code snippets into the editor.

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;