Quickstart: Create an Azure Event Hubs schema registry using Azure portal

Azure Schema Registry is a feature of Event Hubs, which provides a central repository for schemas for event-driven and messaging-centric applications. It provides the flexibility for your producer and consumer applications to exchange data without having to manage and share the schema. It also provides a simple governance framework for reusable schemas and defines relationship between schemas through a grouping construct (schema groups). For more information, see Azure Schema Registry in Event Hubs.

This article shows you how to create a schema group with schemas in a schema registry hosted by Azure Event Hubs.


  • The feature isn't available in the basic tier.
  • Make sure that you are a member of one of these roles: Owner, Contributor, or Schema Registry Contributor. For details about role-based access control, see Schema Registry overview.
  • If the event hub is in a virtual network, you won't be able to create schemas in the Azure portal unless you access the portal from a VM in the same virtual network.
  • The Schema Registry functionality isn't supported for namespaces with private endpoint enabled.


Create an Event Hubs namespace. You can also use an existing namespace.

Create a schema group

  1. Navigate to the Event Hubs Namespace page.

  2. Select Schema Registry on the left menu. To create a schema group, select + Schema Group on the toolbar.

    Image showing the Schema Registry page in the Azure portal

  3. On the Create Schema Group page, do these steps:

    1. Enter a name for the schema group.

    2. For Serialization type, select Avro serialization format that applies to all schemas in the schema group. JSON serialization format is also supported (preview).

    3. Select a compatibility mode for all schemas in the group. For Avro, forward and backward compatibility modes are supported.

    4. Then, select Create to create the schema group.

      Image showing the page for creating a schema group

  4. Select the name of the schema group in the list of schema groups.

    Image showing schema group in the list selected.

  5. You see the Schema Group page for the group.

    Image showing the Schema Group page

Add a schema to the schema group

In this section, you add a schema to the schema group using the Azure portal.

  1. On the Schema Group page, select + Schema on the toolbar.

  2. On the Create Schema page, do these steps:

    1. For Name, enter orderschema.

    2. Enter the following schema into the text box. You can also select file with the schema.

        "namespace": "com.azure.schemaregistry.samples",
        "type": "record",
        "name": "Order",
        "fields": [
            "name": "id",
            "type": "string"
            "name": "amount",
            "type": "double"
    3. Select Create.

  3. Select the schema from the list of schemas.

    Image showing the schema selected.

  4. You see the Schema Overview page for the schema.

    Image showing the Schema Overview page.

  5. If there are multiple versions of a schema, you see them in the Versions drop-down list. Select a version to switch to that version schema.

Create a new version of schema

  1. Update the schema in the text box, and select Validate. In the following example, a new field description has been added to the schema.

    Image showing the Update schema page

  2. Review validation status and changes, and select Save.

    Image showing the Review page that shows validation status, changes, and save

  3. You see that 2 is selected for the version on the Schema Overview page.

    Image showing the new version of schema

  4. Select 1 to see the version 1 of the schema.

Clean up resources


Don't clean up resources if you want to continue to the next quick start linked from Next steps.

  1. Navigate to the Event Hubs Namespace page.
  2. Select Schema Registry on the left menu.
  3. Select the schema group you created in this quickstart.
  4. On the Schema Group page, select Delete on the toolbar.
  5. On the Delete Schema Group page, type the name of the schema group, and select Delete.

Next steps