From d3a0576db563d44a8f34e878fe873654aa9195bd Mon Sep 17 00:00:00 2001 From: Pavindu Lakshan Date: Wed, 29 Jul 2026 15:01:51 +0530 Subject: [PATCH 1/2] Clarify branding inheritance behavior after customization Explicitly document that once an organization customizes its branding (organization-wide or application-specific), it stops picking up subsequent branding changes made by ancestor organizations, until it reverts to inherited values. Addresses customer confusion about whether "inheritance" implies live propagation of parent changes. Co-Authored-By: Claude Sonnet 5 --- .../inheritance-in-organizations/ui-branding-inheritance.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/en/includes/guides/organization-management/inheritance-in-organizations/ui-branding-inheritance.md b/en/includes/guides/organization-management/inheritance-in-organizations/ui-branding-inheritance.md index 41baa20c60..48713ed381 100644 --- a/en/includes/guides/organization-management/inheritance-in-organizations/ui-branding-inheritance.md +++ b/en/includes/guides/organization-management/inheritance-in-organizations/ui-branding-inheritance.md @@ -16,6 +16,9 @@ Organization-wide branding settings apply to all applications within the organiz - Organizations can customize their own branding settings, overriding the inherited settings. These overridden settings then pass down to the organization’s descendants. + !!! note "Customized branding does not track later ancestor changes" + Once an organization customizes its branding, it stops inheriting from its ancestors. Any branding changes made later at an ancestor level are **not** propagated to it; the organization keeps using its own customized settings independently. This continues until the organization reverts its branding, at which point it resumes inheriting from the nearest ancestor with custom settings. + - Organizations can also revert their branding settings, restoring the inherited values. ### Application-specific branding @@ -36,6 +39,9 @@ Application-specific branding settings apply to a single application. For a give - Organizations can customize their own application-specific branding settings, overriding either their organization-wide settings or the inherited settings. These overridden settings then pass down to the organization’s descendants. + !!! note "Customized branding does not track later ancestor changes" + Once an organization customizes its application-specific branding, it stops inheriting from its ancestors for that application. Any branding changes made later at an ancestor level are **not** propagated to it; the organization keeps using its own customized settings independently. This continues until the organization reverts its branding, at which point it resumes inheriting from the nearest ancestor with custom settings. + - Organizations can also revert application-specific branding settings. When reverted, the application uses the organization’s custom branding settings. If the organization has no custom branding, it inherits the branding from the nearest parent organization in the hierarchy that has custom settings. !!! note "Reverting affects the entire branding configuration" From 56a9d663206bb64f0ba869a129d1acdb60ded8b0 Mon Sep 17 00:00:00 2001 From: Pavindu Lakshan Date: Thu, 30 Jul 2026 11:44:43 +0530 Subject: [PATCH 2/2] Address review comments --- .../inheritance-in-organizations/ui-branding-inheritance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/includes/guides/organization-management/inheritance-in-organizations/ui-branding-inheritance.md b/en/includes/guides/organization-management/inheritance-in-organizations/ui-branding-inheritance.md index 48713ed381..70192908e4 100644 --- a/en/includes/guides/organization-management/inheritance-in-organizations/ui-branding-inheritance.md +++ b/en/includes/guides/organization-management/inheritance-in-organizations/ui-branding-inheritance.md @@ -40,7 +40,7 @@ Application-specific branding settings apply to a single application. For a give - Organizations can customize their own application-specific branding settings, overriding either their organization-wide settings or the inherited settings. These overridden settings then pass down to the organization’s descendants. !!! note "Customized branding does not track later ancestor changes" - Once an organization customizes its application-specific branding, it stops inheriting from its ancestors for that application. Any branding changes made later at an ancestor level are **not** propagated to it; the organization keeps using its own customized settings independently. This continues until the organization reverts its branding, at which point it resumes inheriting from the nearest ancestor with custom settings. + Once an organization customizes its application-specific branding, it stops inheriting from its ancestors for that application. Any branding changes made later at an ancestor level are **not** propagated to it; the application keeps using its own customized settings independently. This continues until the application-specific branding is reverted, at which point it resumes using the organization’s own organization-wide branding if available, or otherwise inherits from the nearest ancestor. - Organizations can also revert application-specific branding settings. When reverted, the application uses the organization’s custom branding settings. If the organization has no custom branding, it inherits the branding from the nearest parent organization in the hierarchy that has custom settings.