update sharepoint site theming docs (#10606)

* update sharepoint site theming json schema

* update

* update site theming overview

* update site theme csom

* update sharepoint theme rest api

* update theme json store schema

* update

* update image

* update

* update

* update doc

* update doc

* update csom doc

* update

* update version

---------

Co-authored-by: rongqizhou <rongqizhou+odspmdb@microsoft.com>

Author: RongqiZ

docs/declarative-customization/images/default-themes.png

@@ -1,7 +1,7 @@
 ---
 title: SharePoint site theming - CSOM development
 description: The SharePoint client-side object model (CSOM) provides access to the SharePoint object model from code that is running locally or on a different server than SharePoint.
-ms.date: 06/28/2022
+ms.date: 02/25/2026
 ms.localizationpriority: high
 ---
 
@@ -16,11 +16,11 @@ Before you get started, make sure that you're familiar with the following:
 - [Using the Client Object Model](https://msdn.microsoft.com/library/ff798388.aspx)
 - [Common Programming Tasks in the Managed Client Object Model](https://msdn.microsoft.com/library/ee537013.aspx)
 
-You also need to reference the [Microsoft.SharePointOnline.CSOM](https://www.nuget.org/packages/Microsoft.SharePointOnline.CSOM/) NuGet package (version 16.1.6906.1200 or later).
+You also need to reference the [Microsoft.SharePointOnline.CSOM](https://www.nuget.org/packages/Microsoft.SharePointOnline.CSOM/) NuGet package (version 16.0.27011.12008 or later).
 
 ## CSOM code example
 
-The following example shows how to create a __Microsoft.Online.SharePoint.TenantAdministration.Tenant__ object and call the __GetAllTenantThemes__ method to return a list of themes.
+The following example shows how to create a __Microsoft.Online.SharePoint.TenantAdministration.Tenant__ object and call the __GetAllGlobalThemes__ method to return a list of themes.
 
 > [!NOTE]
 > * The URL used to create the context object includes the _-admin_ suffix because **TenantAdministration** methods work with the admin site.
@@ -41,12 +41,12 @@ var passWord = new SecureString();
 foreach (char c in pwd.ToCharArray()) passWord.AppendChar(c);
 ctx.Credentials = new SharePointOnlineCredentials("admin@mydomain.com", passWord);
 Tenant tenant = new Tenant(ctx);
-ClientObjectList<ThemeProperties> themes = tenant.GetAllTenantThemes();
+ClientObjectList<ThemeProperties> themes = tenant.GetAllGlobalThemes();
 ```
 
 ## Theme definition example
 
-For methods that take a theme argument, the following code defines an __SPOTheme__ class that you can use to create custom themes.
+For methods that take a theme argument, the following code defines an __SPOTheme__ class that you can use to create custom themes. For the new theme format, only the `Name` and `ColorPairs` properties are required. For the legacy theme format, the `Name`, `Palette`, and `IsInverted` properties are required.
 
 ```csharp
 /// <summary> 
@@ -67,6 +67,13 @@ public class SPOTheme 
     public IDictionary<String, String> Palette 
     { 
         get; private set; 
+    } 
+    /// <summary> 
+    /// Specifies the color pairs setting of the theme.
+    /// </summary> 
+    public IDictionary<string, IList<Dictionary<string, string>>> ColorPairs
+    { 
+        get; private set; 
     } 
     /// <summary> 
     /// Specifies whether the theme is inverted, with a dark background and a light foreground. 
@@ -86,44 +93,31 @@ There's currently no supported CSOM API to programmatically apply a theme to a s
 
 Use the following methods to customize the set of available themes for a SharePoint tenant administration site. You can add a new custom theme, update an existing theme, or delete a theme, and you can retrieve a specific theme or all themes. You can also hide or restore the default themes that come with SharePoint.
 
-### AddTenantTheme public method
+### AddTenantThemeAdvanced public method
 
-Add a theme to the tenant.
+Add a theme to the organization.
 
-__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
-__Parameters:__ string name, string themeJson<br/>
-__Return type:__ ClientResult\<bool\>
-
-### DeleteTenantTheme public method
-
-Delete a theme from the tenant.
+In multi-geo environments, themes added by an administrator in the primary geography are automatically propagated and available across the organization. This method is not supported for administrators in satellite geographies.
 
 __Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
-__Parameters:__ string name<br/>
-__Return type:__ void
-
-### GetAllTenantThemes public method
-
-Retrieve all the themes that are currently available in the tenant, including any custom themes that have been added. Default themes are only included if the __HideDefaultThemes__ property is __false__ (the default value).
-
-__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
-__Parameters:__ none<br/>
-__Return type:__ ClientObjectList\<ThemeProperties\>
+__Parameters:__ string name, string themeJson, bool shouldParseColorPair<br/>
+__Return type:__ ClientResult\<bool\>
 
-### GetTenantTheme public method
+### UpdateTenantThemeAdvanced public method
 
-Retrieve a theme by name.
+Update the settings for an existing theme.
 
 __Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
-__Parameters:__ string name<br/>
-__Return type:__ ThemeProperties
+__Parameters:__ string name, string themeJson, bool shouldParseColorPair<br/>
+__Return type:__ ClientResult\<bool\>
 
-### HideDefaultThemes public property
+### AddTenantTheme public method
 
-This property indicates whether the default themes are available in the theme picker UI. The default setting is __false__ (the default themes are available), but you might want to set this property to __true__ after you define custom themes, to allow only specific themes to be used.
+Add a theme to the organization. This method is not supported for administrators in satellite geographies.
 
 __Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
-__Type:__ Boolean
+__Parameters:__ string name, string themeJson<br/>
+__Return type:__ ClientResult\<bool\>
 
 ### UpdateTenantTheme public method
 
@@ -132,58 +126,56 @@ Update the settings for an existing theme.
 __Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
 __Parameters:__ string name, string themeJson<br/>
 __Return type:__ ClientResult\<bool\>
+### DeleteTenantTheme public method
 
-## Methods of the Microsoft.Online.SharePoint.TenantManagement.Tenant class
+Delete a theme from the tenant.
 
-These are alternative APIs to manage your themes at the tenant level.
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Parameters:__ string name<br/>
+__Return type:__ void
 
-### AddTenantTheme public method
+### GetAllGlobalThemes public method
 
-Add a theme to the tenant.
+Retrieve the complete set of custom themes defined at the tenant level, including themes created through command-based tools and those created in the Brand Center UI. 
+> [!NOTE]
+> To support consistent branding and simplify governance, theme management is transitioning to a centralized model.
+> - The **primary geo** will act as the central location for **organization-wide theme creation and management**. Themes created here will be visible and applicable across satellite geos.
+> - The satellite **Geo Administrators** will be able to view themes from the primary geo to their own sites by using `GetAllGlobalThemes` method. Themes previously created within satellite geos will remain available for use. However, **creating new themes in satellite geos will no longer be supported** going forward.
 
-__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
-__Parameters:__ string name, string themeJson<br/>
-__Return type:__ ClientResult\<bool\>
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Parameters:__ none<br/>
+__Return type:__ ClientObjectList\<ThemeProperties\>
 
 ### GetAllTenantThemes public method
 
-Retrieve all the themes that are currently available in the tenant, including any custom themes that have been added. Default themes are only included if the __HideDefaultThemes__ property is __false__ (the default value).
+Retrieve all the custom themes that are created on current tenant through command-based tools.
 
-__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
 __Parameters:__ none<br/>
 __Return type:__ ClientObjectList\<ThemeProperties\>
 
-### GetHideDefaultThemes public method
+### GetGlobalTheme public method
 
-Read the current setting for whether to hide default themes in the theme picker UI.
+Retrieve a theme by name, including themes created through command-based tools and those created in the Brand Center UI. 
 
-__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
-__Parameters:__ none<br/>
-__Return type:__ ClientResult\<bool\>
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Parameters:__ string name<br/>
+__Return type:__ ThemeProperties
 
 ### GetTenantTheme public method
 
 Retrieve a theme by name.
 
-__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
 __Parameters:__ string name<br/>
 __Return type:__ ThemeProperties
 
-### SetHideDefaultThemes public method
-
-Specify whether to hide default themes in the theme picker UI.
-
-__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
-__Parameters:__ Boolean<br/>
-__Return type:__ void
-
-### UpdateTenantTheme public method
+### HideDefaultThemes public property
 
-Update the settings for an existing theme.
+This property indicates whether the default themes are available in the theme picker UI. The default setting is __false__ (the default themes are available), but you might want to set this property to __true__ after you define custom themes, to allow only specific themes to be used.
 
-__Namespace:__ Microsoft.Online.SharePoint.TenantManagement.Tenant<br/>
-__Parameters:__ string name, string themeJson<br/>
-__Return type:__ ClientResult\<bool\>
+__Namespace:__ Microsoft.Online.SharePoint.TenantAdministration.Tenant<br/>
+__Type:__ Boolean
 
 ## See also