Skip to main content

Overview

A credential schema is the blueprint for a credential. It defines the structure and meaning of a credential's claims, enabling data consistency and automation. This documentation section is the definitive resource for managing these schemas, providing the tools and concepts necessary to:

  • Ensure data integrity

    Define schemas that guarantee data consistency for production-ready solutions.

  • Facilitate interoperability

    Share schemas with external partners to ensure a common understanding of data.

  • Control schema evolution

    Manage changes to your schemas over time by publishing new, distinct versions.

note

This section is designed to serve a diverse audience, from developers learning to manage schemas after creating their first credential, to architects seeking robust data governance for their projects.

The meta-schema: a universal definition​

At the core of the Truvity platform is a universal meta-schema, which serves as a single source of truth for defining a credential's claims. This meta-schema is format-agnostic, which means you define your schema once, and Truvity automatically translates it into the specific format (for example, VCDM schema definition) required for the credentials you issue.

This approach ensures that your schemas are always consistent and interoperable across different specifications.

UDTs: the developer's tool for schema definition​

For developers using the Truvity SDK, user-defined types (UDTs) are the recommended way to define meta-schemas in your code. The SDK automatically translates your UDT into the platform's meta-schema representation, simplifying the process of defining complex credential structures and providing a better developer experience.

Getting started with schema management​

After defining your schema with a UDT, you can manage its entire lifecycle. The following sections guide you through this process, from foundational concepts to advanced management techniques.

  • Core concepts

    Build your foundational knowledge by learning about Truvity's meta-schema model, schema types, and publication principles.

  • Manage schemas

    Learn how to perform hands-on tasks, including creating, publishing, versioning, and duplicating schemas using the SDK and API.

  • How-to guides

    Follow end-to-end, scenario-based guides for prototyping schemas and building schema-driven applications.