Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt

Use this file to discover all available pages before exploring further.

Transparency settings let you manage how your organization appears on the public Trust Explorer directory. When enabled, verifiers can look up your organization and confirm that attestations were issued by a legitimate, publicly listed entity.

​
Prerequisites

  • An active Truthlocks tenant with at least one issuer
  • Tenant admin or owner role

​
What the Trust Explorer shows

The Trust Explorer is a public portal where anyone can browse the transparency log, search attestations, and view issuer profiles. When you opt in to the public directory, your organization’s profile is listed at transparency.truthlocks.com/issuers/<your-slug>. Your public profile displays:
FieldDescription
Display nameYour organization’s public-facing name
WebsiteLink to your official site
LogoYour organization logo (PNG, JPEG, SVG, or WebP — max 2 MB)
Verification tierWhether your organization has been verified
StatusCurrent tenant status (active or pending)
The Trust Explorer only shows structural data — Merkle roots, tree sizes, and cryptographic signatures. No attestation content, PII, or sensitive data is ever exposed.

​
Configure transparency settings

1

Open transparency settings

In the console, go to Settings > Transparency.
2

Opt in to the public directory

Toggle Opt-in to Public Directory on. When enabled, your organization name, website, and verification status appear in the Trust Explorer issuer directory.
3

Set your profile details

Fill in your public display name, official website URL, and upload a logo. The logo can be uploaded directly (max 2 MB) or provided as a URL.
4

Save changes

Click Save Changes to publish your profile.

​
Latest checkpoint

The transparency settings page also shows your latest transparency log checkpoint. This gives you a quick health check on the log without leaving the console:
  • Tree size — total entries in the Merkle tree
  • Signed at — when the checkpoint was signed
  • Root hash — the Merkle root hash for this checkpoint
  • Signer — the key ID that signed the checkpoint
For a detailed view of all checkpoints and search capabilities, visit the Truth Explorer.

​
Verification tiers

Your verification tier determines the trust badge shown on your public profile:
TierMeaning
VerifiedYour organization has completed the governance review process and holds a higher trust tier
BasicYour organization is active with the default trust level assigned on issuer creation
The verification tier is set automatically based on your issuer’s trust level. New issuers start at Basic and can issue attestations immediately. To upgrade to a higher tier, submit an issuer application for review.

​
Transparency settings API

You can also read and update transparency settings through the API: 
# Get current transparency settings
curl https://api.truthlocks.com/v1/settings/transparency \
  -H "X-API-Key: tl_live_..."

# Update transparency settings
curl -X PUT https://api.truthlocks.com/v1/settings/transparency \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "is_public": true,
    "display_name": "Acme Corp",
    "website": "https://acme.com",
    "logo_url": "https://acme.com/logo.png",
    "verification_tier": "verified"
  }'

​
Privacy considerations

Opting in to the public directory is entirely voluntary. When disabled:
  • Your organization does not appear in the issuer directory
  • Attestations you issue are still valid and verifiable by ID
  • Verifiers can still check individual attestation signatures, but cannot browse your profile
When enabled, only the information you configure (display name, website, logo) is shown. Internal details like contact email, region, and tenant type are never exposed on the public profile.

Truth Explorer

Browse the public transparency log, validate proof bundles, and search attestations.

Enterprise branding

Customize your organization’s branding across the console and verify portal.