diff --git a/docs/navigation.php b/docs/navigation.php
index 0d3166a..fbbc1a3 100644
--- a/docs/navigation.php
+++ b/docs/navigation.php
@@ -79,7 +79,8 @@ return [
                 'Tenants'                    => 'tenants',
                 'Central App'                => 'central-app',
                 'Universal Routes'           => 'universal-routes',
-                'Cacheed Tenant Lookup'      => 'cached-tenant-lookup',
+                'Cached Tenant Lookup'      => 'cached-tenant-lookup',
+                'PostgreSQL schema separation' => 'postgres-schema-separation',
                 'Custom Database Names'      => 'custom-database-names',
                 'Custom DB Connections'      => 'custom-db-connections',
                 'Disabling DB Creation'      => 'disabling-db-creation',
diff --git a/docs/source/v2/postgres-schema-separation.blade.md b/docs/source/v2/postgres-schema-separation.blade.md
new file mode 100644
index 0000000..7320d0d
--- /dev/null
+++ b/docs/source/v2/postgres-schema-separation.blade.md
@@ -0,0 +1,15 @@
+---
+title: PostgreSQL schema separation
+description: PostgreSQL schema separation
+extends: _layouts.documentation
+section: content
+---
+
+# PostgreSQL schema separation {#postgresql-schema-separation}
+
+If you're using PostgreSQL, you can separate tenant databases by *schemas* instead of *databases*.
+
+To enable this, set the config like this:
+
+- `tenancy.database.separate_by`: `'schema'` to tell the package how we're separating databases
+- `tenancy.database_managers.pgsql`: `Stancl\Tenancy\TenantDatabaseManagers\PostgreSQLSchemaManager::class` to tell the package to use the schema creator/deleter instead of database creator/deleter for pgsql databases.