---
title: "Display Configuration"
description: "Configure how your issuer appears in wallets via OpenID metadata in the walt.id Enterprise Issuer2 Service."
stack: "Enterprise Stack (commercial) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/enterprise-stack/services/issuer2-service/configurations/display-configuration
generated: 2026-07-20
---
# Display Configuration

The display configuration controls how your issuer service appears in wallet applications. This metadata is exposed via the OpenID4VCI discovery endpoints and helps users identify your organization when receiving credentials.

Every endpoint below shares the same path parameters and authentication:

- **orgID**: _String_ (required) - Your organization ID, e.g. `test.enterprise-sandbox.waltid.dev`.
- **target**: _String_ (required) - The resource identifier of the issuer service, `{organizationID}.{tenantID}.{issuerServiceID}`, e.g. `waltid.tenant1.issuer1`.
- **Authorization**: _String_ (required) - Bearer token. Format: `Bearer {token}`.

---

## View Display Configuration

Retrieve the current display configuration for your issuer service.

**Option: CURL**

**Endpoint:** `GET /v2/{target}/issuer-service-api/configuration/openid-metadata/display/view` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html)

##### Example Request

```bash
curl -X 'GET' \
  'https://{orgID}.enterprise-sandbox.waltid.dev/v2/{target}/issuer-service-api/configuration/openid-metadata/display/view' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {yourToken}'
```

---

##### Example Response

```json
[
  {
    "name": "walt.id Enterprise Issuer",
    "locale": "en-US",
    "logo": {
      "uri": "https://cdn.walt.id/issuer/logo.png",
      "alt_text": "walt.id logo"
    }
  }
]
```

**Response Codes**

- `200` — Display configuration returned.
- `401` — Invalid or missing authentication token.

---

## Update Display Configuration

Replace the display metadata for your issuer service. The body is an array of display entries, one per locale.

**Option: CURL**

**Endpoint:** `PUT /v2/{target}/issuer-service-api/configuration/openid-metadata/display/update` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html)

##### Example Request

```bash
curl -X 'PUT' \
  'https://{orgID}.enterprise-sandbox.waltid.dev/v2/{target}/issuer-service-api/configuration/openid-metadata/display/update' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {yourToken}' \
  -H 'Content-Type: application/json' \
  -d '[
  {
    "name": "My Organization Issuer",
    "locale": "en-US",
    "logo": {
      "uri": "https://example.com/logo.png",
      "alt_text": "My Organization logo"
    }
  },
  {
    "name": "Mon Organisation Émetteur",
    "locale": "fr-FR",
    "logo": {
      "uri": "https://example.com/logo.png",
      "alt_text": "Logo de mon organisation"
    }
  }
]'
```

**Body Parameters**

The body is a JSON array of display entries:

- **name**: _String_ (optional) - Display name of the issuer.
- **locale**: _String_ (optional) - Language/locale code (e.g. `en-US`, `de-DE`, `fr-FR`). Each locale may appear only once.
- **logo**: _Object_ (optional) - Logo configuration.
  - **uri**: _String_ (required) - URL to the logo image.
  - **alt_text**: _String_ (optional) - Alternative text for the logo.

---

##### Example Response

```json
[
  {
    "name": "My Organization Issuer",
    "locale": "en-US",
    "logo": {
      "uri": "https://example.com/logo.png",
      "alt_text": "My Organization logo"
    }
  }
]
```

**Response Codes**

- `200` — Display configuration updated.
- `400` — Invalid request body (e.g. duplicate locales).
- `401` — Invalid or missing authentication token.

---

## Delete Display Configuration

Remove the display configuration from your issuer service.

**Option: CURL**

**Endpoint:** `DELETE /v2/{target}/issuer-service-api/configuration/openid-metadata/display/delete` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html)

##### Example Request

```bash
curl -X 'DELETE' \
  'https://{orgID}.enterprise-sandbox.waltid.dev/v2/{target}/issuer-service-api/configuration/openid-metadata/display/delete' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {yourToken}'
```

---

##### Example Response

An empty body with status `200`.

**Response Codes**

- `200` — Display configuration deleted successfully.
- `401` — Invalid or missing authentication token.

---

## Display Configuration Properties

| Property | Type | Description |
|----------|------|-------------|
| `name` | String | Display name of the issuer. |
| `locale` | String | Language/locale code (e.g. `en-US`, `de-DE`, `fr-FR`). |
| `logo` | Object | Logo configuration. |
| `logo.uri` | String | URL to the logo image. |
| `logo.alt_text` | String | Alternative text for the logo. |

## Multi-Language Support

The display configuration supports multiple locales, allowing wallets to show localized issuer information based on the user's language preference:

```json
[
  {
    "name": "University of Technology",
    "locale": "en-US",
    "logo": { "uri": "https://university.edu/logo.png", "alt_text": "University logo" }
  },
  {
    "name": "Technische Universität",
    "locale": "de-DE",
    "logo": { "uri": "https://university.edu/logo.png", "alt_text": "Universitätslogo" }
  },
  {
    "name": "Université de Technologie",
    "locale": "fr-FR",
    "logo": { "uri": "https://university.edu/logo.png", "alt_text": "Logo de l'université" }
  }
]
```

The display metadata is served as part of the issuer's OpenID4VCI credential issuer metadata, which wallets fetch to discover and display issuer information during credential issuance.