Logo

Upload a Schema

Common questions this page answers:

  • How do I upload a schema to Bailo?
  • What fields are required when uploading a schema?
  • How do I deactivate a schema?

Upload new schemas from the schema management page. You must hold the admin role to manage schemas.

By default Bailo comes with a default schema for both a model card and an access request. These are added on startup in backend/src/services/v2/schema.ts. These contain a small number of questions, and are not expected to be used on a production system.

  1. To add a new schema, click Schemas in the left navigation bar on a running Bailo instance.
  2. Click the Upload a new Schema button in the top left.

The screenshot above shows the Schemas page on the Model tab, with a populated schema called Minimal Schema v10 displaying the Actions button to one side. An Upload a new Schema is prominently displayed at the top of the page.

  1. Populate the form to create a new schema with fields:
    • Id - A globally unique schema identifier, should include the schema version.
    • Name - A user-facing name for the schema, should include the schema version.
    • Description - Displayed to the user to help them decide which schema to pick. Can include markdown.
    • Schema Type - Either 'Model' or 'Access Request'.
    • Schema - Select a JSON Schema that includes the questions you require.

From the schema list page you can also convert a schema to inactive by pressing the make inactive button in the Actions menu. If a schema is deleted, any models associated with it will be deleted. Converting a schema to 'inactive' reduces it's priority within the UI but does not break any existing models uploaded with it.


Copyright © Crown Copyright 2026.