# PostgREST: what changed from 14 to 16 - Product: PostgREST (https://whatsnew.fyi/product/postgrest) - Vendor: PostgREST - Range: changelog entries numbered after v14.17 up to and including v16.2, stable releases only - Entries below: 3 releases (newest first) - Resolved: 14 is v14.17 and 16 is v16.2, the newest stable release of each major we track - Carrying security changes: 0 · CVEs mentioned: 0 · Mentioning breaking changes: 0 · Removing or deprecating something: 2 - Page: https://whatsnew.fyi/product/postgrest/compare/14...16 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'. ## What changed (26 changes, grouped by kind) ### Added #### v16.2 (2026-08-21) - Make jwt-role-claim-key config backwards compatible - Add deprecation policy documentation #### v16.0 (2026-08-07) - Add graceful shutdown support to the HTTP server - Add server-reuseport configuration option to allow starting multiple PostgREST instances using the same port on supported platforms - Add Prefer: timezone support for numeric offsets like 05:00 or -4 - Add Vary header to responses - Add GHC runtime metrics to observability - Add client-error-verbosity configuration option to customize response error verbosity - Add admin-server-unix-socket and admin-server-unix-socket-mode configuration options to run the admin server on a unix socket - Publish docker images to Github Container Registry in addition to Docker Hub ### Changed #### v16.0 (2026-08-07) - Optimize schema cache domain type resolution by using pg_basetype on PostgreSQL 17+ - Prefer: count=exact no longer does a double count on requests that do not use ranges or db-max-rows - Prefer: timezone no longer requires the schema cache - JWT Role Extraction now supports the standard JSON Path defined in RFC 9535 - Make aarch64-linux executable static instead of Ubuntu-based - Build docker image for aarch64-linux from scratch instead of being Ubuntu-based - log-level configuration is now reloadable ### Fixed #### v16.1 (2026-08-11) - JWT validation uses correct current time, fixing a bug in auto-update #### v16.0 (2026-08-07) - Fix unexpected results when embedding and filtering the same table more than once - Fix automatic transaction retries on 40001 serialization_failure errors to prevent replication lag - Fix responding with Something went wrong on Admin server when under EMFILE - Fix requests failing when the schema cache fails to reload by continuing to serve requests in best effort mode - Fix reporting 503 errors unnecessarily while the schema cache is loading at startup ### Removed #### v16.0 (2026-08-07) - Drop support for PostgreSQL 13 which reached end of life ### Deprecated #### v16.2 (2026-08-21) - The old (pre-v16) syntax for JSPath in jwt-role-claim-key is deprecated, with warnings logged when old syntax is used #### v16.0 (2026-08-07) - Deprecate filters, orders and limits with the name of an embedded table when it has an alias ## Release notes ### v16.2 - Date: 2026-08-21 - Version: v16.2 - Original notes: https://github.com/PostgREST/postgrest/releases/tag/v16.2 - Permalink: https://whatsnew.fyi/product/postgrest/releases/v16.2 - **added** — Make jwt-role-claim-key config backwards compatible - **added** — Add deprecation policy documentation - **deprecated** — The old (pre-v16) syntax for JSPath in jwt-role-claim-key is deprecated, with warnings logged when old syntax is used ###### Added - Make `jwt-role-claim-key` config backwards compatible by @taimoorzaeem in #5171 - [Deprecation policy](https://docs.postgrest.org/en/v16/#deprecation-policy) by @steve-chavez on #5173 ###### Deprecated - The old (pre-v16) syntax for JSPath in `jwt-role-claim-key` is deprecated by @taimoorzaeem in #5171 + You will see a warning in the logs when old syntax is used for the config. + See [migration to v16](https://github.com/PostgREST/postgrest/blob/main/CHANGELOG.md#migration-to-v16) section for migration guide. ### v16.1 - Date: 2026-08-11 - Version: v16.1 - Original notes: https://github.com/PostgREST/postgrest/releases/tag/v16.1 - Permalink: https://whatsnew.fyi/product/postgrest/releases/v16.1 - **fixed** — JWT validation uses correct current time, fixing a bug in auto-update ###### Fixed - JWT validation uses wrong current time due to a bug in auto-update by @mkleczek in #5159 ### v16.0 - 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 - **added** — Add graceful shutdown support to the HTTP server - **added** — Add server-reuseport configuration option to allow starting multiple PostgREST instances using the same port on supported platforms - **added** — Add Prefer: timezone support for numeric offsets like 05:00 or -4 - **added** — Add Vary header to responses - **added** — Add GHC runtime metrics to observability - **added** — Add client-error-verbosity configuration option to customize response error verbosity - **added** — Add admin-server-unix-socket and admin-server-unix-socket-mode configuration options 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** — JWT Role Extraction now supports the standard JSON Path defined in RFC 9535 - **changed** — Make aarch64-linux executable static instead of Ubuntu-based - **changed** — Build docker image for aarch64-linux from scratch instead of being 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 40001 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 - **removed** — Drop support for PostgreSQL 13 which reached end of life ###### 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]_