Skip to content

[Excel] (Custom functions) Document unified manifest support#5596

Open
alison-mk wants to merge 13 commits intomainfrom
alison-mk-cf-unified-manifest
Open

[Excel] (Custom functions) Document unified manifest support#5596
alison-mk wants to merge 13 commits intomainfrom
alison-mk-cf-unified-manifest

Conversation

@alison-mk
Copy link
Copy Markdown
Contributor

@alison-mk alison-mk commented Feb 7, 2026

This PR documents how to use the unified manifest for Microsoft 365 with custom functions add-ins. Once the unified manifest for custom functions is declared GA, this PR should be merged.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

@alison-mk alison-mk added the Status: Do Not Merge Do Not Merge label Feb 7, 2026
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 4a80766:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File Status Preview URL Details
docs/excel/custom-functions-unified-manifest.md ❌Error Details

docs/excel/custom-functions-unified-manifest.md

  • Line 15, Column 1: [Error: include-not-found - See documentation] Invalid include link: '../includes/unified-manifest-support-note.md'.

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
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 1a8692f:

✅ Validation status: passed

File Status Preview URL Details
docs/develop/configure-your-add-in-to-use-a-shared-runtime.md ✅Succeeded View
docs/develop/convert-xml-to-json-manifest.md ✅Succeeded View
docs/excel/custom-functions-json.md ✅Succeeded View
docs/excel/custom-functions-naming.md ✅Succeeded View
docs/excel/custom-functions-overview.md ✅Succeeded View
docs/excel/custom-functions-troubleshooting.md ✅Succeeded View
docs/excel/custom-functions-unified-manifest.md ✅Succeeded View
docs/includes/excel-custom-functions-note.md ✅Succeeded n/a (file deleted or renamed)
docs/quickstarts/excel-custom-functions-quickstart.md ✅Succeeded View
docs/toc.yml ✅Succeeded View

For more details, please refer to the build report.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 9ddd838:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/develop/configure-your-add-in-to-use-a-shared-runtime.md ⚠️Warning View Details
docs/toc.yml ⚠️Warning View Details
docs/develop/convert-xml-to-json-manifest.md ✅Succeeded View
docs/excel/custom-functions-json.md ✅Succeeded View
docs/excel/custom-functions-naming.md ✅Succeeded View
docs/excel/custom-functions-overview.md ✅Succeeded View
docs/excel/custom-functions-troubleshooting.md ✅Succeeded View
docs/includes/excel-custom-functions-note.md ✅Succeeded n/a (file deleted or renamed)
docs/quickstarts/excel-custom-functions-quickstart.md ✅Succeeded View

docs/develop/configure-your-add-in-to-use-a-shared-runtime.md

  • Line 25, Column 87: [Warning: file-not-found - See documentation] Invalid file link: '../excel/custom-functions-unified-manifest.md'.

docs/toc.yml

  • Line 713, Column 13: [Warning: file-not-found - See documentation] Invalid file link: 'excel/custom-functions-unified-manifest.md'.

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
Copy link
Copy Markdown
Contributor

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.

@alison-mk alison-mk marked this pull request as ready for review April 21, 2026 03:11
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 5a6261f:

✅ Validation status: passed

File Status Preview URL Details
docs/excel/custom-functions-json.md ✅Succeeded View
docs/excel/custom-functions-naming.md ✅Succeeded View
docs/excel/custom-functions-overview.md ✅Succeeded View
docs/excel/custom-functions-troubleshooting.md ✅Succeeded View
docs/includes/excel-custom-functions-note.md ✅Succeeded n/a (file deleted or renamed)
docs/quickstarts/excel-custom-functions-quickstart.md ✅Succeeded View

For more details, please refer to the build report.

@alison-mk alison-mk requested a review from Copilot April 21, 2026 03:13
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 807cdf9:

✅ Validation status: passed

File Status Preview URL Details
docs/excel/custom-functions-json.md ✅Succeeded View
docs/excel/custom-functions-naming.md ✅Succeeded View
docs/excel/custom-functions-overview.md ✅Succeeded View
docs/excel/custom-functions-troubleshooting.md ✅Succeeded View
docs/includes/excel-custom-functions-note.md ✅Succeeded n/a (file deleted or renamed)
docs/quickstarts/excel-custom-functions-quickstart.md ✅Succeeded View

For more details, please refer to the build report.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates Excel custom functions documentation to describe unified manifest (Microsoft 365) support, replacing prior guidance that required the add-in-only (XML) manifest.

Changes:

  • Adds unified-manifest instructions/examples across custom functions overview, naming, and JSON metadata articles.
  • Removes the shared include note that stated unified manifest doesn’t support custom functions, and removes its usage from related pages.
  • Refreshes article dates and makes minor wording/grammar edits.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
docs/quickstarts/excel-custom-functions-quickstart.md Refreshes ms.date and clarifies a setup step’s wording.
docs/includes/excel-custom-functions-note.md Removes the legacy note that blocked unified-manifest usage.
docs/excel/custom-functions-troubleshooting.md Removes the legacy include note and improves intro/grammar (with one remaining grammar issue noted).
docs/excel/custom-functions-overview.md Adds unified-manifest tabbed guidance for manifest configuration (tab formatting issues noted).
docs/excel/custom-functions-naming.md Adds namespace configuration guidance for both manifest types via tabs.
docs/excel/custom-functions-json.md Adds unified-manifest guidance for connecting metadataUrl via tabs (code fence issue noted).
Comments suppressed due to low confidence (1)

docs/excel/custom-functions-troubleshooting.md:33

  • Grammar/typo: "is also maybe a sign that that function" reads awkwardly and contains a duplicated "that". Rephrase to something like "may also be a sign that the function ..." and remove the duplicate word.
- A `#N/A` error is also maybe a sign that that function while registered could not be run. This is typically due to a missing `CustomFunctions.associate` command.
- A `#VALUE!` error typically indicates an error in the functions' script file.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/excel/custom-functions-json.md Outdated
Comment thread docs/excel/custom-functions-overview.md Outdated
Comment thread docs/excel/custom-functions-overview.md
Comment thread docs/excel/custom-functions-overview.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Alison McKay <almckay@microsoft.com>
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 2226565:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/excel/custom-functions-json.md ⚠️Warning View Details
docs/excel/custom-functions-naming.md ✅Succeeded View
docs/excel/custom-functions-overview.md ✅Succeeded View
docs/excel/custom-functions-troubleshooting.md ✅Succeeded View
docs/includes/excel-custom-functions-note.md ✅Succeeded n/a (file deleted or renamed)
docs/quickstarts/excel-custom-functions-quickstart.md ✅Succeeded View

docs/excel/custom-functions-json.md

  • Line 66, Column 2: [Warning: disallowed-html-tag - See documentation] HTML tag 'Resources' isn't allowed. Replace it with approved Markdown or escape the brackets if the content is a placeholder.

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
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

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
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit c9d9a72:

✅ Validation status: passed

File Status Preview URL Details
docs/excel/custom-functions-json.md ✅Succeeded View
docs/excel/custom-functions-naming.md ✅Succeeded View
docs/excel/custom-functions-overview.md ✅Succeeded View
docs/excel/custom-functions-troubleshooting.md ✅Succeeded View
docs/includes/excel-custom-functions-note.md ✅Succeeded n/a (file deleted or renamed)
docs/quickstarts/excel-custom-functions-quickstart.md ✅Succeeded View

For more details, please refer to the build report.

Copy link
Copy Markdown
Contributor

@Rick-Kirkham Rick-Kirkham left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great job!

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 607f2fb:

✅ Validation status: passed

File Status Preview URL Details
docs/excel/custom-functions-debugging.md ✅Succeeded View
docs/excel/custom-functions-json.md ✅Succeeded View
docs/excel/custom-functions-naming.md ✅Succeeded View
docs/excel/custom-functions-overview.md ✅Succeeded View
docs/excel/custom-functions-troubleshooting.md ✅Succeeded View
docs/includes/excel-custom-functions-note.md ✅Succeeded n/a (file deleted or renamed)
docs/quickstarts/excel-custom-functions-quickstart.md ✅Succeeded View

For more details, please refer to the build report.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants