Credential Designs: Issuer Branding
Catalog id: resource.credentialDesigns.issuer-designs
An issuer design is how the issuer organization appears to holders and verifiers: display name, description, logo, and optional render card for issuer-level presentation. It is not a credential type. Credential designs may reference an issuer design so many credential types share the same authority branding.
Guide context: Credential designs.
Open it
| Navigation | Resources > Credential Designs > Issuer Branding |
| Deep link | #resource=credentialDesigns&rarea=issuer-designs |
| Scope | Tenant |
List
Inventory of issuer designs for the tenant (alias, hosting mode, binding summary such as issuer DID). Open a row to edit. Create when the product did not seed branding, or when you need a second authority face for a second issuer instance.
Create
Minimum identity to register the issuer face:
- Alias for operators and automation.
- Display name holders see as the issuer name.
- Issuer DID (or other binding your product uses) so metadata and wallets can correlate the brand with the signing identity.
After create, finish localization and logos on the workbench. Prefer uploading logos under Assets first, then attaching them here or on a render variant.
Detail workbench
Overview
Alias, hosting mode, and bindings (issuer DID / issuer instance). Wrong DID binding makes wallets show a name that does not match the keys that signed the credential.
Localization
Per-locale display name and description. Use the locales your holders actually see. Incomplete localization falls back to the default locale.
Source JSON
Raw document for import/export style edits. Prefer the structured tabs for day-to-day work.
REST
Create issuer design:
- Overview
- Request
- Response
Create issuer design
Endpoint: POST /api/credential-design/v1/designs/issuers
Captured response: 201 Created
This captured endpoint is shown from the E2E run; it is not mapped to one of the generated EDK REST API reference pages.
Connect an environment to rewrite this call to real service bases and run it.
Upload logo asset (then reference the returned URI):
- Overview
- Request
- Response
Upload issuer logo asset
Endpoint: POST /api/credential-design/v1/designs/credentials/00000000-0000-4000-8000-000000000000/assets/en/LOGO
Captured response: 201 Created
This captured endpoint is shown from the E2E run; it is not mapped to one of the generated EDK REST API reference pages.
Connect an environment to rewrite this call to real service bases and run it.
Create a render variant for issuer presentation:
- Overview
- Request
- Response
Create issuer render variant
Endpoint: POST /api/credential-design/v1/designs/render/variants
Captured response: 201 Created
This captured endpoint is shown from the E2E run; it is not mapped to one of the generated EDK REST API reference pages.
Connect an environment to rewrite this call to real service bases and run it.
Attach the variant to the issuer design:
- Overview
- Request
- Response
Attach render variant to issuer design
Endpoint: PUT /api/credential-design/v1/designs/issuers/00000000-0000-4000-8000-000000000000
Captured response: 200 OK
This captured endpoint is shown from the E2E run; it is not mapped to one of the generated EDK REST API reference pages.
Connect an environment to rewrite this call to real service bases and run it.
Credential design API. Guide: Credential designs.