[DRAFT] update sharepoint site theming docs

[RongqiZ]

Category

• Content fix
• New article
• Example checked item (delete this line)

DELETE THIS LINE BEFORE SUBMITTING | For the above list, an empty checkbox is [ ] as in [SPACE]. A checked checkbox is [x] with no space between the brackets. Use the PREVIEW tab at the top right to preview the rendering before submitting your issue.

Related issues

• fixes #issuenumber
• partially #issuenumber
• mentioned in #issuenumber

DELETE THIS LINE BEFORE SUBMITTING | If this fixes (aka: closes) or references an issue, please reference it here. This helps maintaining the issue list as it will (1) link the PR to the issue & (2) automatically close the issue when this PR is merged in.

What's in this Pull Request?

DELETE THIS LINE BEFORE SUBMITTING | Please describe the changes in this PR. Sample description or details around bugs which are being fixed.

Submission guidelines

• !!IMPORTANT!! - All submissions must complete the baseline sections included in this template. Ignoring or deleting this template may result in closing the issue with the label type:incomplete-submission.
• Follow our guidance on How To Create Good Pull Requests.
• Target the main branch of this repo.
• When changing a page, ensure you update the ms.date front matter wih the current date in the format MM/DD/YYYY.
• Review all build checks and address the automated errors, warnings, and suggestions.
• NOTE: The live site is based on the live branch. Site owners periodically refresh live branch from the main branch so merged PRs won't immediately appear on the live site. Please be patient to see your changes appear on the live site.

DELETE THIS SECTION BEFORE SUBMITTING

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 8ea662e:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 6bab3ab:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

Learn Build status updates of commit 8742409:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 48f1316:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 51e16fb:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 2bbe35c:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 13945a2:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 80dac3f:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 3bae9d8:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 88aa827:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View

For more details, please refer to the build report.

[andrewconnell]

FYI - before submitting this PR for review, ensure you follow the guidelines for PRs on this repo: How to Create Good Pull Requests ▶ Fill out all sections (and remove guidance).

This is mandatory.

[learn-build-service-prod]

Learn Build status updates of commit 0d2b7eb:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
	❌Error		Details

• [Error: CannotMergeCommit] Cannot merge commit 0d2b7ebf128c3102497a073ed8edd629c6799901 in branch user/rongqizhou/updateSiteThemeDocs of repository https://github.com/RongqiZ/sp-dev-docs into branch main (commit b2d2762ec4ec1b1a3ba669671ade92ac7eaab703). Please follow this documentation: https://help.github.com/articles/resolving-a-merge-conflict-using-the-command-line/ to use git.exe to resolve you content conflicts locally and then push to remote.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 5f47914:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit d330f9d:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View
docs/images/theme-defaults.png	✅Succeeded	n/a (file deleted or renamed)

For more details, please refer to the build report.

[learn-build-service-prod]

Learn Build status updates of commit aa1eea0:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View
docs/images/theme-defaults.png	✅Succeeded	n/a (file deleted or renamed)

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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]

Learn Build status updates of commit 764565a:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/declarative-customization/images/default-themes.png	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-csom.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-json-schema.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-overview.md	✅Succeeded	View
docs/declarative-customization/site-theming/sharepoint-site-theming-rest-api.md	✅Succeeded	View
docs/images/theme-defaults.png	✅Succeeded	n/a (file deleted or renamed)

For more details, please refer to the build report.