Edit the configuration settings for topics

View and edit the configuration settings for topics.


Some topic configuration parameters are not configurable through this interface. These unmodifiable parameters display a lock symbol (lock) in the text entry box. They cannot be changed in either default or expert mode. See Configurable topic parameters.

Edit basic topic settings

  1. Select a cluster from the navigation bar.

  2. Click the Topics cluster submenu. The All Topics page appears.

  3. In the Topics table, click the ellipsis (...) next to the topic name and choose Settings.

    Topics context menu in Control Center
  4. The Configuration page appears for the topic. Click Edit settings.

    Configuration page for a topic in Control Center


    Click Show/Hide full config to toggle the view of all available configurations.

  5. The basic configurations become available for editing. Only the most commonly modified settings are shown by default. Make any changes to the available fields. To edit additional settings in expert mode, see Edit topic settings in expert mode.

    Basic configuration editing page for a topic in Control Center


    Click the information icon to view the tooltip for a setting.

    Tooltip for a topic setting in Control Center
  6. Click Save changes.

Edit topic settings in expert mode


Be careful when setting configurations in expert mode. With expert mode, you have full control of every topic configuration and can potentially get your cluster into a bad state.

  1. Follow the steps for Edit basic topic settings. On the basic configuration page, click Switch to export mode.

  2. To leave expert mode without making any changes, click Leave expert mode.

  3. Make your changes. Scroll down to the bottom of the page and click Save changes.

    Edit topic configuration in export mode of Control Center

Configurable topic parameters

The following table lists available parameters in alphabetical order and indicates whether they can be edited. Most can be edited with the exception of the topic name and number of partitions.

Parameter Configurable
cleanup.policy Yes
cluster Yes
compression.type Yes
delete.retention.ms Yes
file.delete.delay.ms Yes
flush.messages Yes
flush.ms Yes
follower.replication.throttled.replicas Yes
index.interval.bytes Yes
leader.replication.throttled.replicas Yes
max.message.bytes Yes
message.format.version Yes
message.timestamp.difference.max.ms Yes
message.timestamp.type Yes
min.cleanable.dirty.ratio Yes
min.compaction.lag.ms Yes
min.insync.replicas Yes
name (topic) No
partitions (number of) No
preallocate Yes
producer Yes
replication.factor Yes
retention.bytes Yes
retention.ms Yes
segment.bytes Yes
segment.index.bytes Yes
segment.jitter.ms Yes
segment.ms Yes
unclean.leader.election.enable Yes