Skip to main content
The label reads the same audit state as the project page. When Trustblock holds no audit for the project, the label says so, unless you set data-tb-hide-not-found. For what the label states in each case, every option with its values, and the other ways to show a project’s record (the label as an image, the API, a plain link), see Show your record on your site.

​
Setup

1

Add the script

Import the script to your website entry HTML file as follows:
2

Add the div

If you already know the project you want to display the label for and are not in a dynamic context, then you should use data-tb-project-slug.Head to app.trustblock.run, find the project you want to get the label for, and copy the slug in the URL. GetSlugThen add the div to your website:
Parameters
  • data-tb-project-widget is a required parameter that allows the widget to be initialized.
  • data-tb-project-slug is a required parameter that specifies the slug of the project you want to display the label for.
  • data-tb-color is an optional parameter that specifies the color of the widget, can be light, dark or auto (follows the page behind the label).
  • data-tb-mode is an optional parameter that specifies the sizing behavior of the widget, can be fit or fill.
  • data-tb-hide-not-found is an optional flag that hides the widget when Trustblock holds no audit for the project.
  • data-tb-variant is an optional parameter: badge (the default: the label, with the options below) or label (the small form: “Audits on Trustblock” with the latest audit’s firm and date; it takes no other option).
  • data-tb-show is an optional parameter: the facts the label states. Left out (or auto), the label shows the project’s three strongest facts (Automatic). Else a comma list of date, firm, reports, fixed, since, firms, chains, site, audits, or none for the first line alone.
  • data-tb-fixed is an optional parameter: findings fixed as count (default, “214 of 231 findings fixed”) or percent (“93% of findings fixed”).
  • data-tb-link is an optional parameter: record (default, the project’s page) or the id of one of the project’s audits (that audit’s page).
  • data-tb-layout is an optional parameter: standard (default, two lines), compact (one line) or card (up to 5 facts, one a line).
  • data-tb-accent is an optional parameter: purple (default), blue, slate or ink.
  • data-tb-size is an optional parameter: medium (default), small or large.
  • data-tb-shape is an optional parameter: rounded (default), pill or square.
  • data-tb-date is an optional parameter: the date format, month (default, Aug 2026), long (20 Aug 2026), iso (2026-08-20) or slash (2026/08/20).
  • data-tb-lang is an optional parameter: en (default), fr, es, de or pt.

​
Give it a try on our playground