Schema Registry User Guide
Also available as:

Adding a New Schema

About This Task

To add a new schema to Schema Registry, provide information about the schema entities, select a compatibility policy and upload the schema text from a file. Schema entities are the collection of information that help you organize and sort your schemas. They include group, version, and informational metadata.


  • Ensure that you understand compatibility policies. Once selected, you cannot change the compatibility policy for a schema.


  1. From the Schema Registry UI, click the + icon.

  2. Add the Schema metadata as follows:

    • Name – A unique name for each schema. Used as a key to look up schemas.

    • Description – A short description of the schema.

    • Schema Type – The schema format.


      Avro is currently the only supported type.

    • Schema Group – Allows you to group schemas in any logical order.

    • Compatibility – Sets the compatibility policy for the schema. Once set, this cannot be changed.

  3. To allow schema to evolve over time by creating multiple versions, select the Evolve checkbox.


    Deselecting Evolve means that you can only have one version of a schema.

  4. Click Choose File to upload a new schema.

More Information

Schema Entities

Compatibility Policies