Skip to main content

Create Credential Template

A credential template defines a single credential type: its format, attributes, validity period, and how the credential card is displayed. When you issue a credential — manually or via the API — you pick a credential template; the actual credential is created based on its configuration.

Every credential template belongs to an issuer template.

Open the credential templates list​

  1. Go to Settings → Templates (under Issuer).
  2. Open the issuer template you want to add a credential template to.
  3. Switch to the Credential templates tab.
Credential templates list with create / import tile and existing credential cards

From here you can:

  • Create new template — start from a blank credential template
  • Import template — import a credential template that was previously exported

Existing credential templates are shown as cards displaying the issuer name, credential type, and credential format.

Credential configuration​

The top of the credential template form sets the identifier and supported languages.

  • Credential Issue template key (required) — A unique key for this template. Issuance clients pass this key to the Start Issue Credential API to identify the template.
  • Select languages — Pick the languages for which you want to provide specific translations.

Type tab​

Configure what kind of credential this template issues.

Type tab of the credential template
  • Credential format — Pick from SD-JWT VC, VC-JWT, or JSON-LD.
  • Type — The credential type identifier, e.g. BankAccountCredential.
  • Validity period — A number and a time unit (Seconds, Minutes, Days, Months, Years).
  • Store issued credential — When enabled, the credential is stored in your wallet after issuance. Stored credentials can be viewed under Issuer → Issued.

The Export and Delete buttons at the top of the form let you export the credential template to JSON (for re-import into another wallet) or remove it entirely.

Display tab​

Define how the credential card is displayed. Settings can be configured per language; the Default language is used as a fallback.

Display tab showing the credential card preview
  • Type of credential — The type or label shown on the credential card (e.g. IBAN).
  • Background Image URL — Optional URL of a background image for the credential card.
  • Background Color — Used when no background image is provided.
  • Text Color — Color of the text on the card.

A live preview of the card is shown next to the settings.

Attributes tab​

Define the attributes that make up the credential.

Attributes tab

Each attribute has:

  • Attribute Name — The key used in the credential, e.g. currency.
  • Attribute Type — One of Complex Type, String, Integer, Number, Boolean.
  • Disclosable — Whether the attribute can be selectively disclosed.
  • Is Array — Whether the attribute can contain multiple values.
  • Required — Whether the attribute must be included in the credential.

You can add or remove attributes, or import the attribute set directly from a JSON Schema to speed up configuration and stay consistent with an external definition.

Translations tab​

Configure translations for the attribute display names. These are the labels shown on the credential card.

Translations tab

All attributes defined on the Attributes tab appear here. For each language, enter the display name that should appear on the credential card.

Suggest translations​

Click Suggest translations to auto-fill the Translated label column for the currently selected language tab. The button derives a human-readable label from each attribute's technical name (for example, companyname → Company name) and translates it into the language of the active tab.

Use it to bootstrap a new language tab — empty fields are filled in one click — and then refine any labels that need a more domain-specific wording.

Template tab​

The Template tab lets you configure a custom credential template. Use it only when you need to customize the credential and the automatic template generation isn't sufficient for your use case.

Status tab​

The Status tab links the credential to a status list, which is used to communicate the credential's status (e.g. valid, revoked) after issuance. Configure status lists under Settings → Credential status before linking them here.

Issue tab​

Use the Issue tab to manually issue a credential and verify the configuration end-to-end. See Issue a credential manually.

Save​

Click Save configuration at the bottom of the form to save changes across all tabs. A "Save to apply changes across all tabs" hint appears when you have unsaved changes.

Required permission

You need the Issuer templates (Change) permission to create, edit, or delete credential templates.