From 9f586cb039bcac40862db222a16a8550ec3cae42 Mon Sep 17 00:00:00 2001
From: Dharin Shah <8616130+Dharin-shah@users.noreply.github.com>
Date: Tue, 6 Jan 2026 18:45:44 +0100
Subject: [PATCH] doc: clarify pg_extension is per-database, not cluster-wide

---
 doc/src/sgml/catalogs.sgml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml
index 2fc63442980..fa13f9a9d5c 100644
--- a/doc/src/sgml/catalogs.sgml
+++ b/doc/src/sgml/catalogs.sgml
@@ -3964,6 +3964,13 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
    for details about extensions.
   </para>
 
+  <para>
+   Like most system catalogs, <structname>pg_extension</structname> is not
+   shared across databases: there is one copy of <structname>pg_extension</structname>
+   per database, not one per cluster.  Consequently, extensions must be
+   installed separately in each database where they are needed.
+  </para>
+
   <table>
    <title><structname>pg_extension</structname> Columns</title>
    <tgroup cols="1">
-- 
2.39.3 (Apple Git-146)