---
title: "Issuer Display"
description: "The issuer metadata display options enable the issuer service to expose details such as issuer name and logo in a standardized way with other services such as digital wallets. These services can then use this…"
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/issuer-service/configurations/openid-metadata/issuer-display
generated: 2026-07-20
---
# Issuer Display

The issuer metadata display options enable the issuer service to expose details such as issuer name and logo in a
standardized way with other services such as digital wallets. These services can then use this information to display
a human-readable issuer name and logo to the end-user during credential exchange.

Learn more about the display options in the OID4VCI
standard [here](https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0.html#name-credential-issuer-metadata:~:text=display%3A%20OPTIONAL.%20Array%20of%20objects%2C%20where%20each%20object%20contains%20display,String%20value%20of%20the%20alternative%20text%20for%20the%20logo%20image).

The display info is exposed via the public
endpoints `/.well-known/openid-credential-issuer`, `/.well-known/oauth-authorization-server`, `/.well-known/openid-configuration`

## Example of Display Options

Here is an example of how display options can be provided in the issuer service.

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

This allows the issuer to specify localized names and logos, ensuring that users in different regions can view
the information in their preferred language and format.

## Get Display Options

**Option: CURL**

Endpoint: `/v1/{target}/issuer-service-api/configuration/openid-metadata/display/view` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html#/Service%20%7C%20Issuer%20Service/get_v1__target__issuer_service_api_configuration_openid_metadata_display_view)

**Example Request**

```bash
curl -X 'GET' \
  'http://waltid.enterprise.localhost:8000/v1/{target}/issuer-service-api/configuration/openid-metadata/display/view' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {yourToken}' 
```

**Path Parameters**

- `orgID`: - When performing operations within an organization, it is essential to use the organization's Base URL or
  another valid host alias. For example, if your organization is named `test`, your default Base URL will
  be `test.enterprise-sandbox.walt.dev` when using the sandbox environment.
- `target`: _resourceIdentifier_ - The target indicates the organization + tenant + issuer from which to retrieve the
  issuer display info (`{organizationID}.{tenantID}.[NewIssuerServiceID]`), e.g. `waltid.tenant1.issuer1`

**Response**

- `200` - Config retrieved successfully.

```json
[
  {
    "name": "walt.id Enterprise Issuer Service",
    "locale": "en-US",
    "logo": {
      "uri": "http://cdn.walt.id/issuer/logo.png",
      "alt_text": "logo specific text goes here"
    }
  }
]
```

- `401` - Invalid authentication

## Update Display Options

**Option: CURL**

Endpoint: `/v1/{target}/issuer-service-api/configuration/openid-metadata/display/update` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html#/Service%20%7C%20Issuer%20Service/put_v1__target__issuer_service_api_configuration_openid_metadata_display_update)

**Example Request**

```bash
curl -X 'PUT' \
  'http://waltid.enterprise.localhost:8000/v1/{target}/issuer-service-api/configuration/openid-metadata/display/update' \
  -H 'accept: */*' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {yourToken}' \
  -d '[
  {
    "name": "walt.id Enterprise Issuer Service",
    "locale": "en-US",
    "logo": {
      "uri": "http://cdn.walt.id/issuer/logo.png"
    }
  },
  {
    "name": "walt.id Enterprise Issuer Service",
    "locale": "en-GB",
    "logo": {
      "uri": "http://cdn.walt.id/issuer/logo.png"
    }
  }
]'
```

**Path Parameters**

- `orgID`: - When performing operations within an organization, it is essential to use the organization's Base URL or
  another valid host alias. For example, if your organization is named `test`, your default Base URL will
  be `test.enterprise-sandbox.walt.dev` when using the sandbox environment.
- `target`: _resourceIdentifier_ - The target indicates the organization + tenant + issuer in which to update the
  issuer display info (`{organizationID}.{tenantID}.[NewIssuerServiceID]`), e.g. `waltid.tenant1.issuer1`

**Body**

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

**Body Parameters**

The body is structured as a list of objects, with each object offering specific display information for different
languages. Providing the `local` option is optional, so it is enough to specify just one object if no localization
is needed.

**Display Config Object**

```json
{
  "name": "walt.id Enterprise Issuer Service",
  "locale": "en-US",
  "logo": {
    "uri": "http://cdn.walt.id/issuer/logo.png",
    "alt_text": "Logo of walt.id Enterprise Issuer Service"
  }
}
```

- `name` (optional) _String_: String value of a display name for the Credential Issuer.
- `locale` (optional) _String_: String value that identifies the language of this object represented as a language tag
  taken from values defined in
  BCP47 [RFC5646](https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0.html#RFC5646). There MUST be only
  one object for each language identifier. Example values are: `en-US`, `de-DE`, or `fr-FR`.
- `logo` (optional) _Object_: Object with information about the logo of the Credential Issuer.
    - `uri` _String_: String value that contains a URI where the Wallet can obtain the logo of the Credential Issuer.
    - `alt_text` (optional) _String_: String value of the alternative text for the logo image.

---

**Response**

- `200` - Config updated successfully.

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

- `401` - Invalid authentication

## Delete Display Options

**Option: CURL**

Endpoint: `/v1/{target}/issuer-service-api/configuration/openid-metadata/display/delete` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html#/Service%20%7C%20Issuer%20Service/delete_v1__target__issuer_service_api_configuration_openid_metadata_display_delete)

**Example Request**

```bash
curl -X 'DELETE' \
  'http://waltid.enterprise.localhost:8000/v1/{target}/issuer-service-api/configuration/openid-metadata/display/delete' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {yourToken}'
```

**Path Parameters**

- `orgID`: - When performing operations within an organization, it is essential to use the organization's Base URL or
  another valid host alias. For example, if your organization is named `test`, your default Base URL will
  be `test.enterprise-sandbox.walt.dev` when using the sandbox environment.
- `target`: _resourceIdentifier_ - The target indicates the organization + tenant + issuer in which to delete the
  issuer display info (`{organizationID}.{tenantID}.[NewIssuerServiceID]`), e.g. `waltid.tenant1.issuer1`

---

**Response**

- `200` - Config deleted successfully.

- `401` - Invalid authentication