# Credential Schemas

### Introduction

Credential schemas define the contents and structure of a set of claims in a verifiable credential. Within the SVX Portal they are used by Organisation Administrators when issuing and verifying credentials. See Issue / Revoke Credentials and Verification Templates for more information. It is the responsibility of the Tenant Administrator to create and manage credential schemas, and assign them to Organisations within their Tenancy.

### Create a credential schema

Tenant Administrators can create new credential schemas by navigating to *Credentials* on the left-side menu of the SVX Portal, and selecting *Credential schemas*. After selecting the *Create credential schema* button, you will be presented with a form. The form consists of the following fields:

* Schema name
* Schema template
  * The option to select from a predefined list of schemas, including: Education Certificate, Student ID, Verifiable ID, and
  * The option to upload a template (this must be a JSON file)
* Available to

> **Note** *Uploaded schema template:* The SVX Portal will check the uploaded schema to ensure it satisfies the predetermined file structure. If the schema does not comply, the system will advise the user via a notification message. The file must be uploaded as a JSON file.

> **Note** The *Available to* field allows you to make schemas available to Organisations within your Tenancy. You can always add or remove Organisations.

When a predefined schema template has been selected, an editing panel will be displayed. Tenant Administrators can edit and customise these schema templates.

Once all required fields are complete select the *Create* button and the credential schema will appear in a list with a designated Schema ID and Version Number.

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-5666d765e3d6a38db4f63a6ce50be02c7f79dd58%2F12_TA_Create_new_credential_schema.gif?alt=media" alt="How to create a credential schema tutorial video." width="80%"></div>

### View and edit a credential schema

Tenant Administrators can view credential schemas by navigating to *Credentials* on the left-side menu of the SVX Portal, and selecting *Credential schemas*.

Locate the credential schema in the list and select the horizontal ellipsis icon ⋯ alongside the schema’s name to reveal menu options. Select *View*. You will be presented with the following information:

* Schema Name
* Schema ID
* Version
* Date Authored
* Schema details
* Available to

> **Note** The *Available to* field allows you to make schemas available to Organisations within your Tenancy. You can always add or remove Organisations.

To edit the credential schema, select the *Edit* button from the *View credential schema* page or select *Edit* from the horizontal ellipsis icon ⋯ alongside the schema’s name. The information will be presented as an editable form where you can update / change the following information:

* Available to

When complete, select *Save* to save changes, or *Cancel* to discard changes.

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-bd2ba8c79cee9b991b9e41527a54a816fd065506%2F13_TA_View_and_edit_credential_schema.gif?alt=media" alt="How to view and edit a credential schema tutorial video." width="80%"></div>

### Archive a credential schema

To archive a credential schema navigate to *Credentials* on the left-side menu of the SVX Portal, and select *Credential schemas*. Locate the credential schema in the *Active schemas* tab and select the horizontal ellipsis icon ⋯ alongside the schema’s name to reveal menu options. Select *Archive* and confirm the archiving of the credential schema via the modal window. The credential schema will be removed from the Tenant, and will be moved to the *Archived schemas* tab.

> **Note** *Archiving a credential schema:* Once archived, a credential schema will not be available to Organisations when creating credential and verification templates Note that credential schemas can be restored if required and full functionality will be restored to Organisations.

> **Note** Schemas are not permanently deleted from the system. Once published, it remains accessible through a public link. Credentials that have been issued that reference the schema can still be used.

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-365c79685afda5a3f6a03d3e978242298f4d5ec0%2F14_TA_Archive_credential_schema.gif?alt=media" alt="How to archive a credential schema tutorial video." width="80%"></div>

### Restore a credential schema

To restore a credential schema navigate to *Credentials* on the left-side menu of the SVX Portal, and select *Credential schemas*. Locate the credential schema in the *Archived schemas* tab and select the horizontal ellipsis icon ⋯ alongside the schema’s name to reveal menu options. Select *Restore* and confirm the restoration of the credential schema via the modal window. The credential schema will be restored to the Tenant, and will be moved to the *Active schemas* tab.

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-f4de59b5c14f2ce166b924878feee8eea87bfeb8%2F15_TA_Restore_credential_schema.gif?alt=media" alt="How to restore a credential schema tutorial video." width="80%"></div>
