Specifies the maximum amount of allocated pages for notify / listen queue.
At a glance
| Property | Value |
|---|---|
| Parameter | max_notify_queue_pages |
| Category | Resource Consumption |
| Default | 1048576 |
| Value type | integer |
| Change scope | Server restart required (postgresql.conf) |
| Available in | PostgreSQL 17, 18, 19 (added in 17) |
What it does
Specifies the maximum amount of allocated pages for notify / listen queue. The default value is 1048576. For 8 KB pages it allows to consume up to 8 GB of disk space. This parameter can only be set at server start.
(Description quoted from the official PostgreSQL documentation.)
How to apply a change
Set it in postgresql.conf (or with ALTER SYSTEM) and restart the server — this parameter cannot change without a restart.
Inspect the current value and source with SHOW max_notify_queue_pages; or SELECT name, setting, unit, context, source FROM pg_settings WHERE name = 'max_notify_queue_pages';.
Tuning guidance
This parameter is rarely a performance lever. Leave it at the default unless you have a specific, documented reason to change it, change it on one session or one role/database first, and confirm the effect with pg_settings and your own measurements before rolling it out cluster-wide.