Configure Confluent Schema Registry compatibility modes for JSON Schema and Protobuf subjects

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

Steps

  1. Recognize that compatibility modes (BACKWARD, FORWARD, FULL, NONE, and their _TRANSITIVE variants) are the same mode set across Avro, JSON Schema, and Protobuf subjects, but the underlying evolution rules differ per schema type.
  2. Set a subject-specific mode where needed instead of relying purely on the global default (BACKWARD), since Protobuf and JSON Schema evolution semantics don't always match Avro's.
  3. Before registering a new schema version, test it with POST /compatibility/subjects/{subject}/versions/{version} (version accepts an integer or latest) and add ?verbose=true for failure reasons.
  4. For Protobuf subjects, prefer BACKWARD_TRANSITIVE over plain BACKWARD/FORWARD — adding a new message type is not forward-compatible, so FORWARD mode rejects a change BACKWARD_TRANSITIVE would allow.
  5. Re-run the compatibility check in CI against the actual target subject/version before a service deploy, rather than only checking once during local development.

Known gotchas

Related routes

Manage Kafka Schema Registry compatibility modes
docs.confluent.io · 5 steps · unrated
Configure and validate Confluent Schema Registry subject compatibility modes before deploying a schema change
docs.confluent.io · 5 steps · unrated
Register Protobuf schema references in Confluent Schema Registry to model cross-schema imports
docs.confluent.io · 6 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