# Trust registry reference

> Field reference for the trust registry editor in the Agent Gateway dashboard.
A trust registry record represents a live DIDComm connection to an external verification service. The gateway establishes this connection via an OOB invitation URL and queries the registry over the connection to look up agent trust records.

For conceptual background, see [Trust registries](/products/affinidi-trust-fabric/agent-gateway/concepts/connections/trust-registry.md). For step-by-step instructions, see [Add a trust registry](/products/affinidi-trust-fabric/agent-gateway/how-to-guides.md).

## Fields

| Field | Editable | Description |
| Name | Yes | Human-readable display name. Appears in Issuer configuration and logs. |
| Description | Yes | Optional description of the trust registry’s purpose or governance framework. |
| OOB URL | No | The OOB invitation URL provided by the trust registry administrator. Used to establish the initial DIDComm connection. Set at creation. |
| DID Method | No | The DID method used to generate the per-registry identity: web (did:web) or peer (did:peer). Set at creation. |
| Our DID | No | The gateway’s per-registry DID, created during the OOB handshake. This is the DID the trust registry uses to identify this gateway. Populated after the handshake completes. |
| Registry DID | No | The trust registry’s DIDComm identity, discovered during the OOB handshake. |
| Main DID | No | The canonical DID of the trust registry. This is the DID that agents reference in their trust-registry extensions (trust_registry_did field). Populated from the OOB invitation. |
| Mediator URL | No | Mediator endpoint auto-discovered from the OOB invitation. |
| Connection Status | No | Current connection state: connecting, awaiting_approval, connected, disconnected, or failed. See [Connection statuses](#connection-statuses). |
| Status | Yes (via delete/recreate) | active or disabled. Disabled registries are excluded from Issuer configuration. |

## Connection statuses

| Status | Meaning |
| connecting | The OOB handshake is in progress. |
| awaiting_approval | Setup message sent; waiting for the trust registry administrator to approve. |
| connected | Connection is established. TRQP queries can be issued. |
| disconnected | Previously connected; use Reconnect to re-establish. |
| failed | Connection failed; use Reconnect to retry. |

## Actions

| Action | Available when | Description |
| Reconnect | Status is disconnected or failed. | Re-initiates the DIDComm handshake using the stored OOB URL. |
| Heartbeat | Status is connected. | Sends a test query to confirm the connection is live. Returns Ping to "<name>" successful (<ms>ms) on success. |

## Related

- [Add a trust registry](/products/affinidi-trust-fabric/agent-gateway/how-to-guides.md): Step-by-step guide using these fields.

- [Trust registries](/products/affinidi-trust-fabric/agent-gateway/concepts/connections/trust-registry.md): Conceptual background.