Credential Designs: Render Variants
Catalog id: resource.credentialDesigns.render-variants
A render variant describes how a credential (or issuer) may be drawn in a wallet: colours, logo, background, or an SVG template. Variants are tenant-level library objects. Credential designs and issuer designs attach them; they do not own exclusive copies.
Kinds you can author in the console today: SIMPLE_CARD and SVG_TEMPLATE. Other kinds may appear read-only when imported or preserved from external sources.
Guide context: Credential designs.
Open it
| Navigation | Resources > Credential Designs > Render Variants |
| Deep link | #resource=credentialDesigns&rarea=render-variants |
| Scope | Tenant |
List
Alias, kind, and locale applicability (all locales vs a subset). Open a row to edit. Delete only when no design still prefers that variant for a locale holders care about.
Create
Choose kind and alias. For SVG template, supply the template asset URI (upload under Assets first). Simple card starts with empty colours and logo slots you fill on the detail editor.
Detail (simple card)
Set background and text colours, logo and optional background image (from the asset library), and which locales this variant applies to. Locale applicability matters when one design uses different cards for EN vs NL: prefer the right variant on the credential design Render tab per locale.
Unsupported kinds open read-only so you do not lose imported data.
REST
Create variants (EuPid EN/NL example):
- Overview
- Request
- Response
Create EuPid render variant (en)
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.
- Overview
- Request
- Response
Create EuPid render variant (nl)
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 variants to a credential design:
- Overview
- Request
- Response
Attach render variants to EuPid design
Endpoint: PUT /api/credential-design/v1/designs/credentials/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.