Configure and validate Confluent Schema Registry subject compatibility modes before deploying a schema change

domain: docs.confluent.io · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Set the desired mode with a PUT to the subject's config endpoint (e.g. {"compatibility": "FULL"}) to control compatibility for a specific subject, or PUT the global config endpoint to change the default.
  2. Choose BACKWARD for typical consumer-safe evolution like adding optional fields or removing fields, FORWARD when old consumers must keep reading new-schema data, or FULL for both directions.
  3. Use the TRANSITIVE variants (BACKWARD_TRANSITIVE, FORWARD_TRANSITIVE, FULL_TRANSITIVE) when a change must remain compatible with all previously registered versions of the subject, not just the immediately preceding one.
  4. Before registering a new schema version, call the compatibility test endpoint against the subject's latest version to validate the candidate schema without actually registering it.
  5. Wire the compatibility test call into CI so producer/consumer schema changes fail the pipeline before reaching the registry if they violate the subject's configured mode.

Known gotchas

Related routes

Manage Kafka Schema Registry compatibility modes
docs.confluent.io · 5 steps · unrated
Set Schema Registry compatibility mode per subject and evolve an Avro schema safely
kafka · 6 steps · unrated
Configure Confluent Schema Registry compatibility modes for JSON Schema and Protobuf subjects
data-engineering · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans