TrustBox widgets - FAQ

TrustBoxes are our widgets. You can use them to display your reviews on your website pages to show your customers your awesome products and services. Here’s some FAQs about them.

Implementation

How do I add a TrustBox widget to my website?

It depends on what type of widget you want to use. Check out this section for a list of guides on how to set them up. 

How can I include a TrustBox widget to my marketing campaigns?

You can add a TrustBox Signature widget to your email signatures, which allows you to put trust directly into your email signature, and promote your reputation with every outgoing email. Or, add a TrustBox Newsletter widget, which allows you to share your reviews and TrustScore with customers in your newsletters.

Can I implement a TrustBox widget 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 can also switch from Visual to Text edit mode in WordPress, then paste the widget's JavaScript and HTML code snippets into the editor.

Display issues

How do I change my TrustBox widget's language?

You can do two things. You can change the widget's display language and then choose to only show reviews that match that language. 

  1. In Trustpilot Business, go to Share & promote > Website widgets > All widgets. Choose your widget.
  2. Under Customize, use the Widget language drop-down to choose your language.

If you’ve chosen a widget 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. Under Widget language, ensure the toggle Only select reviews written in this language is on.

This is the default setting. You can also switch the toggle off to display reviews written in all languages. Once you’ve made your changes, click Get code and replace your old widget code with this updated one.

Can I change the color of my TrustBox widget?

On certain pricing plans, you can change the font color of widgets that display service reviews. You can also change the star color of widgets that display product reviews.

Do TrustBox widgets use responsive design?

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

Widgets are embedded in an iFrame on your website. The iFrame doesn't fully support resizing, so widgets aren't completely fluid in all dimensions. When you resize your browser window, the widget'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 widget's minimum height.

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

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

Create a responsive state by overriding the height of the iFrame to be larger on mobile. You can wrap the widget 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="https://uk.trustpilot.com/review/mywebsite.com" target="_blank">Trustpilot</a>
</div>
<!-- End TrustBox widget -->
</div>
<style>
/* Target mobile displays with a media query */
@media (max-width: ...) {
  .carousel {
width: 320px;
  }
  .carousel iframe {
height: 290px !important;
  }
}
</style>

Loading issues

How does a TrustBox widget affect web page weight?

A TrustBox widget adds on average 50 kB of extra weight, depending on the type and how much data it displays. Widgets that have a layered display, such as the Pop-Up or the Drop-Down, will average around 100 kB of extra weight.

This only applies the first time a user loads a page. When loading the page a second time, our requests account for only about 1 kB, as the browser uses cached data instead of loading it from our servers.

The data comprise a very small proportion of the average web page's overall size. This is illustrated in the table below.

Page Size Widget, first load (50 kB) Widget, subsequent loads (1 kB)
1 MB 6.3% 0.09%
2 MB 3.2% 0.05%
5 MB 1.3% 0.02%
7 MB 0.9% 0.014%

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

TrustBox widgets 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 widget content until your page has loaded. Widgets 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.

Why doesn't my TrustBox widget 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 widget 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 widget code (the second code snippet). 

What happens to my TrustBox widget if Trustpilot is down?

TrustBox widgets have an extra layer of fallback cache (30 days), so it 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, widgets display a fallback logo.

Can adblockers block a TrustBox widget 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 an adblocker won’t be able to block your reviews from being shown. That said, we monitor our widgets to keep this from being a problem.

What browsers are compatible with TrustBox widgets?

They work with Chrome, Firefox, Safari, and Edge. TrustBox widgets aren’t compatible with Safari for Windows or Internet Explorer v. 10 and earlier.

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

Security

What data do TrustBox widgets track?

Our TrustBox widgets track three events: impressions, views, and clicks. These events help you understand how the widget is performing on your business' website. We only collect the data required to track these events, and don’t use cookies or similar technologies. This data is not used for any other purpose and is deleted as soon as it is no longer needed.

It looks like TrustBox widgets are dropping cookies. Why is this?

Our widgets don't require cookies to work, but it may appear that widgets are dropping cookies when in the developer browser view. This is for one of two reasons:

  • Our widgets are built in iframes. Browsers always list iframes in the developer browser view, whether or not cookies are included; and if a user has visited either the Trustpilot consumer or business website and has accepted cookies, cookies will show up in the developer console.
  • Our widgets are hosted on the same domain as our consumer and business sites, and because cookies operate on a domain-by-domain basis, the permissions are the same. The widgets can access the same cookies hosted on the website, but we don't use them. You can test this:
    • Clear your browser cache or open an incognito window (or equivalent on your browser)
    • Go to the site that has the widget. You'll see the iframe in the developer console, but none of the cookies from the consumer/business site.

Do TrustBox widgets support Subresource Integrity (SRI)?

No. 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 don’t apply to our widgets because we don’t 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.

Up next TrustBox widget overview

Related articles