> ## 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

> Control your organization's public profile on the Trust Explorer directory.

Transparency settings let you manage how your organization appears on the public [Trust Explorer](https://transparency.truthlocks.com) 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:

| Field             | Description                                                 |
| ----------------- | ----------------------------------------------------------- |
| Display name      | Your organization's public-facing name                      |
| Website           | Link to your official site                                  |
| Logo              | Your organization logo (PNG, JPEG, SVG, or WebP — max 2 MB) |
| Verification tier | Whether your organization has been verified                 |
| Status            | Current tenant status (active or pending)                   |

<Info>
  The Trust Explorer only shows structural data — Merkle roots, tree sizes, and cryptographic signatures. No attestation content, PII, or sensitive data is ever exposed.
</Info>

## Configure transparency settings

<Steps>
  <Step title="Open transparency settings">
    In the console, go to **Settings > Transparency**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Save changes">
    Click **Save Changes** to publish your profile.
  </Step>
</Steps>

## 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](/guides/truth-explorer).

## Verification tiers

Your verification tier determines the trust badge shown on your public profile:

| Tier         | Meaning                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------- |
| **Verified** | Your organization has completed the governance review process and holds a higher trust tier |
| **Basic**    | Your 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](/guides/issuer-applications) for review.

## Transparency settings API

You can also read and update transparency settings through the API:

```bash theme={null}
# Get current transparency settings
curl https://api.truthlocks.com/v1/settings/transparency \
  -H "X-API-Key: tl_live_..."
```

```bash theme={null}
# 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.

## Related

<CardGroup cols={2}>
  <Card title="Truth Explorer" icon="telescope" href="/guides/truth-explorer">
    Browse the public transparency log, validate proof bundles, and search attestations.
  </Card>

  <Card title="Enterprise branding" icon="palette" href="/guides/enterprise-branding">
    Customize your organization's branding across the console and verify portal.
  </Card>
</CardGroup>