# Mediator

> Field reference for the Mediator editor in the Agent Gateway dashboard, covering the Overview and connection fields.
A mediator is a DIDComm relay that accepts and forwards DIDComm v2.1 messages on behalf of this gateway. When the gateway cannot be reached directly, for example in private networks or NAT environments, a mediator acts as a publicly reachable forwarding point.

For conceptual background on G2G routing and why mediators are needed, see [Gateways](/products/affinidi-trust-fabric/agent-gateway/concepts/connections/gateways.md). For step-by-step setup, see [Connect two gateways](/products/affinidi-trust-fabric/agent-gateway/how-to-guides/connections/connect-gateways.md).

## Overview tab fields

| Setting | Required | Editable | Description |
| Name | Yes | Yes | Human-readable label for this mediator. Used as a display identifier across the dashboard. |
| Description | No | Yes | Optional free-text description of the mediator’s purpose or operator. |
| DID | Yes | Yes | The DID of the mediator service. The gateway uses this to resolve the mediator’s DIDComm endpoint and route outbound messages through it. |
| Status | — | Yes | Whether this mediator is active. See [Status values](#status-values). |

## Status values

| Status | Meaning |
| Active | The mediator is enabled. The gateway routes DIDComm messages through it when it is selected for an outbound connection. |
| Disabled | The mediator is disabled. Outbound routes that reference this mediator will not resolve. Existing connection points that use it stop receiving messages until the mediator is re-enabled or replaced. |

Disabling a mediator does not delete it. The record is preserved so it can be re-enabled without re-entering the DID.

## Metadata

The gateway records the creation and last-update timestamps for each mediator. These fields are read-only and are displayed in the mediator detail view.

| Field | Description |
| Mediator ID | Internal identifier assigned at creation. Used in API calls that reference this mediator. |
| Created | When this mediator record was created. |
| Updated | When this mediator record was last modified. |

## Related

- [Gateway reference](/products/affinidi-trust-fabric/agent-gateway/reference/gateways/gateway.md): Field reference for the gateway editor, including the Global Policy tab.

- [Connection point](/products/affinidi-trust-fabric/agent-gateway/reference/gateways/connection-point.md): Field reference for the connection point editor.

- [Gateways](/products/affinidi-trust-fabric/agent-gateway/concepts/connections/gateways.md): Conceptual overview of gateway types, connection points, and fabric:// routing.
