---
title: "ezgh queues update"
description: "Change a queue's settings, dead-letter queue or tags."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh queues update

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh queues update <queue> [--visibility-timeout t] [--retention t] [--delay t] [--receive-wait t] [--dlq <queue>] [--max-receives n] [--no-dlq] [--content-dedup=true|false] [--tag k=v…] [flags]
```

Change what's given; a queue's name and type are fixed. New visibility timeouts and retention apply to messages from then on: messages in flight keep their deadline.

`--dlq` and `--max-receives` change the dead-letter queue (either alone keeps the other as it is); `--no-dlq` removes it. `--tag` replaces the tags (`--tag` "" clears them).

Part of [`ezgh queues`](/cli/reference/queues).

## Examples

```sh
ezgh queues update orders --visibility-timeout 2m --max-receives 10
ezgh queues update orders --no-dlq
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--content-dedup` | boolean |  | FIFO: deduplicate messages without `--dedup` by their body's SHA-256 (true or false) |
| `--delay` | string |  | the queue's delivery delay, 0 to 15m (default 0) |
| `--dlq` | string |  | the dead-letter queue (name or ID), of the same type, with `--max-receives` |
| `--max-receives` | int |  | receives before a message moves to the dead-letter queue, 1 to 1000 |
| `--no-dlq` | boolean |  | remove the dead-letter queue |
| `--receive-wait` | string |  | the default long-poll wait of a receive, 0 to 20s (default 0) |
| `--retention` | string |  | how long a message is kept: 60s to 14d (default 4d) |
| `--tag` | string, repeatable |  | a tag, key=value (repeat; replaces the tags; `--tag` "" clears them) |
| `--visibility-timeout` | string |  | how long a received message stays hidden: 0 to 12h (default 30s) |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/queues-update/index.mdx