diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsopenpointintimeoptions.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsopenpointintimeoptions.md
index 4b31d30a9e740..fc825e3bf2937 100644
--- a/docs/development/core/server/kibana-plugin-core-server.savedobjectsopenpointintimeoptions.md
+++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsopenpointintimeoptions.md
@@ -16,6 +16,6 @@ export interface SavedObjectsOpenPointInTimeOptions
| Property | Type | Description |
| --- | --- | --- |
| [keepAlive](./kibana-plugin-core-server.savedobjectsopenpointintimeoptions.keepalive.md) | string
| Optionally specify how long ES should keep the PIT alive until the next request. Defaults to 5m
. |
-| [namespaces](./kibana-plugin-core-server.savedobjectsopenpointintimeoptions.namespaces.md) | string[]
| An optional list of namespaces to be used by the PIT. |
+| [namespaces](./kibana-plugin-core-server.savedobjectsopenpointintimeoptions.namespaces.md) | string[]
| An optional list of namespaces to be used when opening the PIT.When the spaces plugin is enabled: - this will default to the user's current space (as determined by the URL) - if specified, the user's current space will be ignored - ['*']
will search across all available spaces |
| [preference](./kibana-plugin-core-server.savedobjectsopenpointintimeoptions.preference.md) | string
| An optional ES preference value to be used for the query. |
diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsopenpointintimeoptions.namespaces.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsopenpointintimeoptions.namespaces.md
index 9fe5f8d09fb0a..06fb7519d52c2 100644
--- a/docs/development/core/server/kibana-plugin-core-server.savedobjectsopenpointintimeoptions.namespaces.md
+++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsopenpointintimeoptions.namespaces.md
@@ -4,7 +4,9 @@
## SavedObjectsOpenPointInTimeOptions.namespaces property
-An optional list of namespaces to be used by the PIT.
+An optional list of namespaces to be used when opening the PIT.
+
+When the spaces plugin is enabled: - this will default to the user's current space (as determined by the URL) - if specified, the user's current space will be ignored - `['*']` will search across all available spaces
Signature:
diff --git a/src/core/server/saved_objects/service/saved_objects_client.ts b/src/core/server/saved_objects/service/saved_objects_client.ts
index 34413e62d4e00..1564df2969ecc 100644
--- a/src/core/server/saved_objects/service/saved_objects_client.ts
+++ b/src/core/server/saved_objects/service/saved_objects_client.ts
@@ -344,7 +344,12 @@ export interface SavedObjectsOpenPointInTimeOptions {
*/
preference?: string;
/**
- * An optional list of namespaces to be used by the PIT.
+ * An optional list of namespaces to be used when opening the PIT.
+ *
+ * When the spaces plugin is enabled:
+ * - this will default to the user's current space (as determined by the URL)
+ * - if specified, the user's current space will be ignored
+ * - `['*']` will search across all available spaces
*/
namespaces?: string[];
}