Docs

Message Queue for RocketMQ

Group management

Resetting consumer offsets

You can reset consumer offsets to consume messages from an earlier time or skip all accumulated messages. This is useful for clearing a backlog or processing offline data. The Message Queue for RocketMQ console allows you to adjust a consumer's current consumption position. You can start consuming from the latest offset or from a specified point in time.

Background information

Message Queue for RocketMQ lets you reset the consumer offset for one topic or all topics to which a group is subscribed. The following reset methods are supported:

Start from the latest offset: When the group consumes messages from this topic, it skips the backlogged messages and begins with those sent after the reset. The backlogged messages are not deleted.

Start from a specified point in time: Select a point in time from the specified past or future time range. This range is determined by the message retention period of the topic, which is three days by default.

Notes

Resetting consumer offsets is not supported in broadcast mode.

Resetting consumer offsets does not affect messages that are being retried. Therefore, after you reset consumer offsets, some retry messages may still be delivered.

To reset consumer offsets with the RocketMQ Go SDK, use the Go SDK community commit (67ec50b93040567856cdbb32c03d607d8c292c3d) or a more recent one. Earlier versions may result in errors or unexpected behavior. For more information, see Go SDK overview.

The Go, Java, and C++ SDKs support resetting consumer offsets when clients are online. For SDKs in other languages, pause the client before resetting the offsets.

Resetting the consumer offset for a group

Resetting the consumer offset for a group resets the offsets of all the topics to which the group is subscribed.

In the top menu bar, select the region of the instance you want to manage.

In the left navigation pane, click Instance List. Then, find the instance on this page and click its name.

Click the Group Management tab, where you can find the list of groups under the instance.

Select the group whose consumer offset needs to be reset. Then, click Reset check point in the Operation column.

Select the reset method.

Start from the latest offset: When the group consumes messages from this topic, it skips the backlogged messages and begins with those sent after the reset. The backlogged messages are not deleted.

Start from a specified point in time: Select a point in time from the specified past or future time range. Only messages sent after that point will be consumed. This range is determined by the message retention period of the topic, which is three days by default.

Click Reset.

Resetting the consumer offset for a topic

In the top menu bar, select the region of the instance you want to manage.

In the left navigation pane, click Instance List. Then, find the instance on this page and click its name.

Click the Group Management tab, where you can find the list of groups under the instance.

Click the ID of the group you want to manage.

Select the subscription information tab. Then, find the topic whose consumer offset you want to reset and click Reset check point in the Operation column.

Select the reset method.

Start from the latest offset: When the group consumes messages from this topic, it skips the backlogged messages and begins with those sent after the reset. The backlogged messages are not deleted.

Start from a specified point in time: Select a point in time from the specified past or future time range. Only messages sent after that point will be consumed. This range is determined by the message retention period of the topic, which is three days by default.

Click Reset.

Last updated: 2026.09.28 11:24:18