# PostgREST v16.0

- Product: PostgREST (https://whatsnew.fyi/product/postgrest)
- Vendor: PostgREST
- Date: 2026-08-07
- Version: v16.0
- Original notes: https://github.com/PostgREST/postgrest/releases/tag/v16.0
- Permalink: https://whatsnew.fyi/product/postgrest/releases/v16.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Add graceful shutdown for HTTP server
- **added** — Add server-reuseport configuration to allow starting multiple PostgREST instances using the same port on supported platforms
- **added** — Add support for JSON Path RFC 9535 in JWT Role Extraction
- **added** — Add numeric offsets like 05:00 or -4 to Prefer: timezone
- **added** — Add Vary header to responses
- **added** — Add GHC runtime metrics for observability
- **added** — Add client-error-verbosity configuration to customize response error verbosity
- **added** — Add admin-server-unix-socket and admin-server-unix-socket-mode to run the admin server on a unix socket
- **added** — Publish Docker images to Github Container Registry in addition to Docker Hub
- **changed** — Optimize schema cache domain type resolution by using pg_basetype on PostgreSQL 17+
- **changed** — Prefer: count=exact no longer does a double count on requests that do not use ranges or db-max-rows
- **changed** — Prefer: timezone no longer requires the schema cache
- **changed** — Make aarch64-linux executable static instead of Ubuntu-based
- **changed** — Build aarch64-linux Docker image from scratch instead of Ubuntu-based
- **changed** — log-level configuration is now reloadable
- **deprecated** — Deprecate filters, orders and limits with the name of an embedded table when it has an alias
- **fixed** — Fix unexpected results when embedding and filtering the same table more than once
- **fixed** — Fix automatic transaction retries on serialization_failure errors to prevent replication lag
- **fixed** — Fix responding with Something went wrong on Admin server when under EMFILE
- **fixed** — Fix requests failing when the schema cache fails to reload by continuing to serve requests in best effort mode
- **fixed** — Fix reporting 503 errors unnecessarily while the schema cache is loading at startup
- **fixed** — Fix schema cache dump missing RPC transaction isolation level
- **fixed** — Fix config db-channel-enabled not reloading
- **removed** — Drop support for PostgreSQL 13

###### Changes

###### HTTP Server

- [Graceful shutdown](https://docs.postgrest.org/en/v16/references/http_server.html#graceful-shutdown) by @mkleczek, @Vlix in #4702

- [server-reuseport](https://docs.postgrest.org/en/v16/references/configuration.html#server-reuseport) allows starting multiple PostgREST instances using the same port on supported platforms by @mkleczek in #4703, #4694

###### Performance

- Optimize schema cache domain type resolution by using [pg_basetype](https://www.postgresql.org/docs/current/functions-info.html#FUNCTIONS-INFO-CATALOG) on PostgreSQL 17+ by @joelonsql in #4567

- [Prefer: count=exact](https://docs.postgrest.org/en/v16/references/api/pagination_count.html#exact-count) no longer does a double count on requests that do not use ranges or `db-max-rows` by @laurenceisla in #3957

- [Prefer: timezone](https://docs.postgrest.org/en/v16/references/api/preferences.html#prefer-timezone) no longer requires the schema cache by @steve-chavez in #5100
  + Previously this required caching [pg_timezone_names](https://www.postgresql.org/docs/current/view-pg-timezone-names.html) which was slow in some systems

###### Integrations

- PostgREST is now tested to work with [OrioleDB](https://github.com/orioledb/orioledb/) in #4845 by @wolfgangwalther 
  + See [our guide for running OrioleDB on NixOS](https://docs.postgrest.org/en/v16/integrations/nixos.html)

###### JWT

- [JWT Role Extraction](https://docs.postgrest.org/en/v16/references/auth.html#jwt-role-extract) is now more flexible, supporting the standard JSON Path defined in RFC 9535 by @taimoorzaeem in #4984

###### API

- [Prefer: timezone](https://docs.postgrest.org/en/v16/references/api/preferences.html#timezone) now supports numeric offsets like `05:00` or `-4` by @steve-chavez in #5100

- Fix unexpected results when embedding and filtering the same table more than once by @laurenceisla in #4075
  + You need to set [url-use-legacy-target-names](https://docs.postgrest.org/en/v16/references/configuration.html#url-use-legacy-target-names) to `false`.

- Deprecate filters, orders and limits with the name of an embedded table when it has an alias by @steve-chavez, @laurenceisla in #4075
  + e.g. `?select=alias:table(*)&table.id=eq.1` will not be possible anymore, use `?select=alias:table(*)&alias.id=eq.1` instead.
  + You will see a warning in the logs and a `Warning` header on the client response when this happens.
  + You can disable this behavior now by setting `url-use-legacy-target-names = false`.

- Add `Vary` header to responses by @develop7 in #4609

- Fix automatic transaction retries on `40001 (serialization_failure)` errors to prevent replication lag by @laurenceisla in #3673

###### Observability

- [GHC runtime metrics](https://docs.postgrest.org/en/v16/references/observability.html#ghc-runtime-metrics) by @mkleczek in #4862
- [client-error-verbosity](https://docs.postgrest.org/en/v16/references/configuration.html#client-error-verbosity) to customize responses error verbosity by @taimoorzaeem in #4088, #3980, #3824
- [log-level](https://docs.postgrest.org/en/v16/references/configuration.html#log-level) config is now reloadable by @taimoorzaeem in #5113
- Log error when `db-schemas` config contains schema `pg_catalog` or `information_schema` by @taimoorzaeem in #4359
- Log schema cache queries timings on `log-level=debug` by @steve-chavez in #4805

###### Admin Server

- [admin-server-unix-socket](https://docs.postgrest.org/en/v16/references/configuration.html#admin-server-unix-socket)/[admin-server-unix-socket-mode](https://docs.postgrest.org/en/v16/references/configuration.html#admin-server-unix-socket-mode) to run the admin server on a unix socket by @wolfgangwalther in #5003
- Fix responding with `Something went wrong` on Admin server when under EMFILE by @mkleczek in #5077

###### Deployment

- Make executable for aarch64-linux static instead of Ubuntu-based by @wolfgangwalther in #

_[Truncated at 4000 characters — full notes: https://github.com/PostgREST/postgrest/releases/tag/v16.0]_