Topic name strategy
TopicNameStrategy is a Schema Registry subject-naming strategy that derives separate key and value subjects from a Kafka topic name.
Kafka Streams in Action, Second Edition
TopicNameStrategy is a Schema Registry subject naming strategy that derives separate key and value subject names from a Kafka topic name.
- How it is used
- Scopes key and value schemas to Kafka topics for default Schema Registry registration and compatibility enforcement.
- How deep it goes
- Explains subject naming, topic-level type constraints, cross-topic schema independence, and schema-reference composition, but defers client implementation details.
- Examples
- Uses key/value subject names, event-type-named topics, and a retailer’s PlaneEvent, TruckEvent, and DeliveryEvent union.
- What you can do after
- Apply it via Schema Registry by deriving <topic>-key and <topic>-value subjects and choosing references when one topic needs related event types.
Read how Kafka Streams in Action, Second Edition explains topic name strategy →
Kafka for Architects
TopicNameStrategy is a Schema Registry subject-naming strategy that groups schema versions by Kafka topic and message component.
- How it is used
- Groups compatible schema versions by Kafka topic and message component.
- How deep it goes
- Defines subject naming, value and key conventions, cross-topic separation, and REST version addressing.
- Examples
- Uses ClientEvent on CLIENTS with CLIENTS-value and contrasts registration on PERSONS with PERSONS-value.
- What you can do after
- Evaluate topic-scoped schema registration and retrieve a specific schema version through the Schema Registry REST API.
Read how Kafka for Architects explains topic name strategy →
Related concepts
- schema referenceused by · A schema reference is a link from one schema to another schema definition, enabling reuse of shared data-structure definitions.
- subject name strategykind of · A subject name strategy is a rule that determines how Schema Registry subject names are derived and therefore where compatibility is checked.
- subjectuses · A subject is a Schema Registry identifier that groups versions of a schema governing a particular event type, topic, or key or value stream.
- topic record name strategycontrasts with · TopicRecordNameStrategy is a Schema Registry subject-naming strategy that derives subjects from a Kafka topic name and a record’s fully qualified name.
- topicuses · A topic is a named messaging destination or stream to which producers publish messages or records and from which consumers receive or read them.
- schema registryused by · A schema registry is a service that stores, versions, and provides schemas for structured data, often validating compatibility between schema versions.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.

