{
  "schema_version": 2,
  "id": "commands/xgroup-delconsumer",
  "title": "XGROUP DELCONSUMER",
  "url": "https://redis.io/docs/latest/commands/xgroup-delconsumer/",
  "summary": "Deletes a consumer from a consumer group.",
  "since": "5.0.0",
  "tags": [
    "docs",
    "develop",
    "stack",
    "oss",
    "rs",
    "rc",
    "oss",
    "kubernetes",
    "clients"
  ],
  "last_updated": "2026-06-15T06:26:34-07:00",
  "page_type": "content",
  "content_hash": "81de9735d7448c2d3a0c89acdbb4b5b875be6b26736a98a2521ffd3b1f739252",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "The `XGROUP DELCONSUMER` command deletes a consumer from the consumer group.\n\nSometimes it may be useful to remove old consumers since they are no longer used.\n\nNote, however, that any pending messages that the consumer had will become unclaimable after it was deleted.\nIt is strongly recommended, therefore, that any pending messages are claimed or acknowledged prior to deleting the consumer from the group."
    },
    {
      "id": "required-arguments",
      "title": "Required arguments",
      "role": "content",
      "text": "<details open><summary><code>key</code></summary>\n\nThe stream key.\n\n</details>\n\n<details open><summary><code>group</code></summary>\n\nThe consumer group name.\n\n</details>\n\n<details open><summary><code>consumer</code></summary>\n\nThe name of the consumer to delete.\n\n</details>"
    },
    {
      "id": "redis-software-and-redis-cloud-compatibility",
      "title": "Redis Software and Redis Cloud compatibility",
      "role": "content",
      "text": "| Redis<br />Software | Redis<br />Cloud | <span style=\"min-width: 9em; display: table-cell\">Notes</span> |\n|:----------------------|:-----------------|:------|\n| <span title=\"Supported\">&#x2705; Standard</span><br /><span title=\"Supported\"><nobr>&#x2705; Active-Active</nobr></span> | <span title=\"Supported\">&#x2705; Standard</span><br /><span title=\"Supported\"><nobr>&#x2705; Active-Active</nobr></span> |  |"
    },
    {
      "id": "return-information",
      "title": "Return information",
      "role": "returns",
      "text": "**RESP2:**\n\n[Integer reply](../../develop/reference/protocol-spec#integers): the number of pending messages the consumer had before it was deleted.\n\n**RESP3:**\n\n[Integer reply](../../develop/reference/protocol-spec#integers): the number of pending messages the consumer had before it was deleted."
    }
  ],
  "examples": []
}