support to add theme v2 for Add-SPOTheme command by RongqiZ · Pull Request #1013 · MicrosoftDocs/OfficeDocs-SharePoint-PowerShell

RongqiZ · 2025-09-02T06:14:47Z

No description provided.

learn-build-service-prod · 2025-09-02T06:15:48Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-02T06:16:43Z

Learn Build status updates of commit bec4e6e:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

learn-build-service-prod · 2025-09-02T06:24:56Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-02T06:25:48Z

Learn Build status updates of commit 7264b9b:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

learn-build-service-prod · 2025-09-02T08:16:40Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-02T08:17:41Z

Learn Build status updates of commit 9fe1baf:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

learn-build-service-prod · 2025-09-02T08:58:52Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-02T08:59:47Z

Learn Build status updates of commit b3a4241:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

learn-build-service-prod · 2025-09-18T07:09:23Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-18T07:10:24Z

Learn Build status updates of commit cd32fb5:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

samkabue · 2025-09-18T16:58:41Z


-The **Add-SPOTheme** cmdlet creates a new theme or updates an existing theme. The color palette settings can be passed as either a hash table or a dictionary.
+## DESCRIPTION
+The **Add-SPOTheme** cmdlet creates a new theme or updates an existing theme. The color pairs settings can be passed as a hash table. The color palette settings can be passed as either a hash table or a dictionary.


The Add-SPOTheme cmdlet

This cmdlet #Closed

samkabue · 2025-09-18T16:59:17Z


-The **Add-SPOTheme** cmdlet creates a new theme or updates an existing theme. The color palette settings can be passed as either a hash table or a dictionary.
+## DESCRIPTION
+The **Add-SPOTheme** cmdlet creates a new theme or updates an existing theme. The color pairs settings can be passed as a hash table. The color palette settings can be passed as either a hash table or a dictionary.


. The

join with "while the" #Closed

samkabue · 2025-09-18T16:59:42Z

+## DESCRIPTION
+The **Add-SPOTheme** cmdlet creates a new theme or updates an existing theme. The color pairs settings can be passed as a hash table. The color palette settings can be passed as either a hash table or a dictionary.

 Adding a theme does not apply the theme to any sites. It adds the theme to your tenant store, and then the theme is available in the list of themes under the **Change the look** option for modern pages.


tenant store

"tenant store" is an internal concept, shouldn't be in docs #Closed

samkabue · 2025-09-18T17:00:03Z

 Adding a theme does not apply the theme to any sites. It adds the theme to your tenant store, and then the theme is available in the list of themes under the **Change the look** option for modern pages.

-## EXAMPLES
+You can choose which parameter set to use depending on the legacy or new theme format you want to add. Please read [Site theme](https://learn.microsoft.com/sharepoint/site-theme) for more about new theme.


Please read

See #Closed

samkabue · 2025-09-18T17:00:28Z

 Adding a theme does not apply the theme to any sites. It adds the theme to your tenant store, and then the theme is available in the list of themes under the **Change the look** option for modern pages.

-## EXAMPLES
+You can choose which parameter set to use depending on the legacy or new theme format you want to add. Please read [Site theme](https://learn.microsoft.com/sharepoint/site-theme) for more about new theme.


https://learn.microsoft.com/sharepoint/site-theme

use relative URL -- /sharepoint/site-theme #Closed

samkabue · 2025-09-18T17:01:01Z

 Adding a theme does not apply the theme to any sites. It adds the theme to your tenant store, and then the theme is available in the list of themes under the **Change the look** option for modern pages.

-## EXAMPLES
+You can choose which parameter set to use depending on the legacy or new theme format you want to add. Please read [Site theme](https://learn.microsoft.com/sharepoint/site-theme) for more about new theme.


have M365 Copilot polish this string -- and other strings.

See the SPO PR for more info on this #Closed

samkabue · 2025-09-18T17:01:22Z


-### Example 1
+> [!NOTE]
+> In multi-geo environments, themes added by an administrator in the primary geography are propagated and available across the entire organization. This` Add-SPOTheme` cmdlet is not supported for administrators in satellite geographies.


This Add-SPOTheme cmdlet

This cmdlet #Closed

samkabue · 2025-09-18T17:02:11Z

+## Examples

-In this example, a new theme named `"Custom Cyan"` is created, with color palette settings that are various shades of cyan. Note that the settings are passed as a hash table.
+### Example 1: Add a new format theme


: Add a new format theme

remove stuff after ":" -- that should go to the example description #Closed

Update other examples too

samkabue · 2025-09-18T17:02:36Z

-In this example, a new theme named `"Custom Cyan"` is created, with color palette settings that are various shades of cyan. Note that the settings are passed as a hash table.
+### Example 1: Add a new format theme
+In this example, a theme named `"Teal Theme"` is created, with color pair settings that are various shades of teal.
+


description comes AFTER the example #Closed

update other examples too

samkabue · 2025-09-18T17:04:11Z

RELATED LINKS

add links for theme related stuff, such as the Stie theme - /sharepoint/site-theme, and maybe other Brand center links #Closed

Refers to: sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md:237 in cd32fb5. [](commit_id = cd32fb5, deletion_comment = False)

learn-build-service-prod · 2025-09-23T08:42:43Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-23T08:43:35Z

Learn Build status updates of commit dea1a3f:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

learn-build-service-prod · 2025-09-23T09:09:51Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-23T09:10:39Z

Learn Build status updates of commit a3a3e3b:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

samkabue · 2025-09-23T22:00:27Z

 > Applicable: SharePoint Online

-Overwrites a theme of the same name in case it exists.
+Specifies the theme’s color pairs using a hash table of slot values. Supports up to 16 color pairs.


’

retype to remove this smart quote ’ #Closed

learn-build-service-prod · 2025-09-24T03:21:58Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-24T03:22:43Z

Learn Build status updates of commit 649fa32:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

samkabue · 2025-09-24T19:15:12Z

RELATED LINKS

@RongqiZ do you have any learn.microsoft.com links you could add here?

In reply to: 3308589010

Refers to: sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md:237 in cd32fb5. [](commit_id = cd32fb5, deletion_comment = False)

learn-build-service-prod · 2025-09-25T01:09:18Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-25T01:10:44Z

Learn Build status updates of commit 788da6c:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

samkabue

learn-build-service-prod · 2025-09-25T05:59:26Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2025-09-25T06:00:58Z

Learn Build status updates of commit 7178aa1:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOTheme.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

support to add theme v2

bec4e6e

github-actions Bot assigned trent-green Sep 2, 2025

github-actions Bot added the Microsoft submitter label Sep 2, 2025

update wording

7264b9b

update new theme colors

9fe1baf

make the theme obj format aligned

b3a4241

add for multi-geo tenants

cd32fb5

samkabue unassigned trent-green Sep 18, 2025

samkabue reviewed Sep 18, 2025

View reviewed changes

update

dea1a3f

RongqiZ marked this pull request as ready for review September 23, 2025 08:41

github-actions Bot assigned trent-green Sep 23, 2025

format colors

a3a3e3b

RongqiZ changed the title ~~[Draft] support to add theme v2 for Add-SPOTheme command~~ support to add theme v2 for Add-SPOTheme command Sep 23, 2025

samkabue reviewed Sep 23, 2025

View reviewed changes

samkabue unassigned trent-green Sep 23, 2025

Fix markdown formatting for color pairs description

649fa32

github-actions Bot assigned trent-green Sep 24, 2025

Add site theme doc to related links

788da6c

samkabue approved these changes Sep 25, 2025

View reviewed changes

samkabue unassigned trent-green Sep 25, 2025

samkabue added the Sign off The pull request is ready to be reviewed and merged by PubOps label Sep 25, 2025

Merge branch 'main' into user/rongqizhou/SupportToAddThemeV2

7178aa1

github-actions Bot assigned samkabue Sep 25, 2025

aditisrivastava07 self-assigned this Sep 25, 2025

aditisrivastava07 added the In review PubOps is reviewing the pull request label Sep 25, 2025

aditisrivastava07 merged commit 5f703e1 into MicrosoftDocs:main Sep 25, 2025
8 checks passed

Conversation

RongqiZ commented Sep 2, 2025

Uh oh!

learn-build-service-prod Bot commented Sep 2, 2025

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Sep 2, 2025

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented Sep 2, 2025

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Sep 2, 2025

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented Sep 2, 2025

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Sep 2, 2025

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented Sep 2, 2025

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Sep 2, 2025

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented Sep 18, 2025

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Sep 18, 2025

✅ Validation status: passed

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025

Choose a reason for hiding this comment

Uh oh!

samkabue Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

samkabue Sep 18, 2025 •

edited

Loading

samkabue Sep 18, 2025 •

edited

Loading

samkabue Sep 18, 2025 •

edited

Loading

samkabue Sep 18, 2025 •

edited

Loading

samkabue Sep 18, 2025 •

edited

Loading

samkabue Sep 18, 2025 •

edited

Loading

samkabue Sep 18, 2025 •

edited

Loading

samkabue Sep 18, 2025 •

edited

Loading

samkabue Sep 18, 2025 •

edited

Loading

samkabue commented Sep 18, 2025 •

edited

Loading

samkabue Sep 23, 2025 •

edited

Loading