Skip to main content
A schema record registers your credential type with AIR so issuance and verification programs can reference it. You register a credential-type identifier (vct) and optionally provide Type Metadata JSON (vctJson) describing the claims. The claim values and selective-disclosure behavior are produced by your issuer backend.
To issue Iden3 credentials, contact the AIR team to enable Iden3 for your account: Partner with us. Once enabled, create Iden3 schemas with the Iden3 Schema Builder.

Plan the credential

Before you open the Dashboard, decide:
  • What the credential proves, and its claims: name, type, and a label for each. Prefer derived claims, such as tier or over_18, over raw personal data.
  • Which claims a holder may disclose on their own. Verifiers can only request those individually.
  • How long each credential stays valid, and where your backend loads the claim data from.
Do not use reserved claim names: cnf, exp, iat, id, iss, nbf, nonce, status, sub, vct. The issuer service sets them.

Choose the vct

The vct is written into every credential you issue, so treat it as permanent. Put a version in the vct. To change claims, labels, or disclosure later, register a new version instead of editing a published one.

Write the Type Metadata

Type Metadata follows IETF SD-JWT VC. The Dashboard reads its claims array to build the claim picker in verification programs, so always provide it.
  • path locates the claim. Nested claims use one segment per level, and verifiers request them as dotted paths, such as address.city.
  • sd: "always" marks a claim the holder can disclose on its own. sd: "never" marks a claim that is visible in every presentation. Match these to your backend’s disclosure configuration.
  • The document must be a JSON object of at most 64 KiB.
If the vct is an HTTPS URL, publish this exact JSON at that URL before you issue.

Register a credential type

  1. Open Issuer → Schemas in the Dashboard for your target environment, and choose SD-JWT VCT details.
  2. Fill in the form:
  3. Publish the record and save its schema ID.
  4. Use that schema record when you create your issuance program with the SD_JWT_VC proof type.
The schema ID identifies the AIR Dashboard record. The vct identifies the credential type inside the signed SD-JWT. They are not interchangeable.

Implement the claims in your backend

Registering the type does not produce claim values. In the reference issuer service, a backend schema class maps the schema ID to the vct, the claims, the disclosure configuration, and the expiry. Use the same vct in the class and in the Dashboard. See Issuing your first credential.