From 49499216c04208360f2cd2fff156099d45abd120 Mon Sep 17 00:00:00 2001
From: alicejw <alicejw@amazon.com>
Date: Wed, 13 Apr 2022 17:18:29 -0700
Subject: [PATCH] for clarifying global and primary tenant functionality per
 doc bug
 https://github.com/opensearch-project/documentation-website/issues/488

Signed-off-by: alicejw <alicejw@amazon.com>
---
 _security-plugin/access-control/multi-tenancy.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/_security-plugin/access-control/multi-tenancy.md b/_security-plugin/access-control/multi-tenancy.md
index fdde01df..a06581f8 100644
--- a/_security-plugin/access-control/multi-tenancy.md
+++ b/_security-plugin/access-control/multi-tenancy.md
@@ -7,7 +7,16 @@ nav_order: 30
 
 # OpenSearch Dashboards multi-tenancy
 
-*Tenants* in OpenSearch Dashboards are spaces for saving index patterns, visualizations, dashboards, and other OpenSearch Dashboards objects. By default, all OpenSearch Dashboards users have access to two tenants: **Private** and **Global**. The global tenant is shared between every OpenSearch Dashboards user. The private tenant is exclusive to each user and can't be shared.
+*Tenants* in OpenSearch Dashboards are spaces for saving index patterns, visualizations, dashboards, and other OpenSearch Dashboards objects. By default, all OpenSearch Dashboards users have access to two tenants:
+
+- **Private -** This tenant is exclusive to each user and can't be shared.
+- **Global -** This tenant is shared between every OpenSearch Dashboards user.
+
+**Note:** The global tenant is not a *primary* tenant such that any action done within the global tenant is not replicated to a user's private tenant. If you make a change to your global tenant, you won't see that change reflected in your private tenant. Some example changes include, but are not limited to:
+
+- Change advanced settings
+- Create visualizations
+- Create index patterns
 
 Tenants are useful for safely sharing your work with other OpenSearch Dashboards users. You can control which roles have access to a tenant and whether those roles have read or write access.