From b1fdc0328fac302794d469101fa247af02ddacca Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Tue, 23 Sep 2025 16:34:59 -0700 Subject: [PATCH 1/2] Draft TaskPaneApi 1.1 --- .../common/office-add-in-requirement-sets.md | 10 +++++- .../common/task-pane-api-requirement-sets.md | 33 +++++++++++++++++++ docs/requirement-sets/requirement-sets.md | 6 ++-- docs/toc.yml | 2 ++ 4 files changed, 47 insertions(+), 4 deletions(-) create mode 100644 docs/requirement-sets/common/task-pane-api-requirement-sets.md diff --git a/docs/requirement-sets/common/office-add-in-requirement-sets.md b/docs/requirement-sets/common/office-add-in-requirement-sets.md index 61c451cac5..f4d3fa31b2 100644 --- a/docs/requirement-sets/common/office-add-in-requirement-sets.md +++ b/docs/requirement-sets/common/office-add-in-requirement-sets.md @@ -1,7 +1,7 @@ --- title: Office Common API requirement sets description: Learn more about the Office Common API requirement sets. -ms.date: 03/11/2025 +ms.date: 09/25/2025 ms.topic: overview ms.localizationpriority: medium --- @@ -248,6 +248,14 @@ See [Add-in command requirement sets](add-in-commands-requirement-sets.md). --- +### TaskPaneApi + +| Minimum Office application support | Methods in set | +|:-----|:-----| +| See [Task Pane API requirement sets](task-pane-api-requirement-sets.md). | | + +--- + ### TextBindings | Minimum Office application support | Methods in set | diff --git a/docs/requirement-sets/common/task-pane-api-requirement-sets.md b/docs/requirement-sets/common/task-pane-api-requirement-sets.md new file mode 100644 index 0000000000..24f11499aa --- /dev/null +++ b/docs/requirement-sets/common/task-pane-api-requirement-sets.md @@ -0,0 +1,33 @@ +--- +title: Task Pane API requirement sets +description: Learn more about the Task Pane API requirement sets and the platforms it supports. +ms.date: 09/25/2025 +ms.topic: overview +ms.localizationpriority: medium +--- + +# Task Pane API requirement sets + +Requirement sets are named groups of API members. Office Add-ins use requirement sets specified in the manifest or use a runtime check to determine whether an Office application supports APIs that an add-in needs. For more information, see [Office versions and requirement sets](/office/dev/add-ins/develop/office-versions-and-requirement-sets). + +With the Task Pane API requirement set, you can manage the task pane of an add-in. For example, you can change the width of an add-in's task pane. + +Office Add-ins run across multiple versions of Office. The following table lists the Task Pane API requirement sets, its supported Office client applications, and the minimum builds or versions for those applications, where applicable. + +| Requirement set | Office on the web | Office on Windows | Office on Mac | Office on iOS | Outlook on Android | +|:-----|:-----|:-----|:-----|:-----|:-----| +| TaskPaneApi 1.1 | | //TODO | Not supported | Not supported | Not supported | + +## Office Common API requirement sets + +For information about Common API requirement sets, see [Office Common API requirement sets](office-add-in-requirement-sets.md). + +## TaskPaneApi 1.1 + +For details about the API, see [Office.TaskPane](/javascript/api/office/office.taskpane). + +## See also + +- [Office versions and requirement sets](/office/dev/add-ins/develop/office-versions-and-requirement-sets) +- [Specify Office applications and API requirements](/office/dev/add-ins/develop/specify-office-hosts-and-api-requirements) +- [Office Add-ins manifest](/office/dev/add-ins/develop/add-in-manifests) diff --git a/docs/requirement-sets/requirement-sets.md b/docs/requirement-sets/requirement-sets.md index c3772cacf4..527324d91b 100644 --- a/docs/requirement-sets/requirement-sets.md +++ b/docs/requirement-sets/requirement-sets.md @@ -1,7 +1,7 @@ --- title: Office client application and platform availability for Office Add-ins description: Supported requirement sets for Excel, OneNote, Outlook, PowerPoint, Project, and Word. -ms.date: 09/09/2025 +ms.date: 09/25/2025 ms.topic: overview ms.localizationpriority: high --- @@ -20,7 +20,7 @@ To work as expected, your Office Add-in might depend on a specific Office applic |Platform|Extension points|Application-specific API requirement sets|[Common API requirement sets](common/office-add-in-requirement-sets.md)| |---|---|---|---| -|Office on the web|||| +|Office on the web|||| |Office on Windows (Microsoft 365 subscription)|||| |Office on Windows
(retail perpetual Office 2016 and later)|||| |Office 2024 on Windows
(volume-licensed perpetual)|||| @@ -82,7 +82,7 @@ To work as expected, your Office Add-in might depend on a specific Office applic |Platform|Extension points|Application-specific API requirement sets|[Common API requirement sets](common/office-add-in-requirement-sets.md)| |---|---|---|---| -|Office on the web|||| +|Office on the web|||| |Office on Windows
(Microsoft 365 subscription)|||| |Office on Windows
(retail perpetual Office 2016 and later)|||| |Office 2024 on Windows
(volume-licensed perpetual)|||| diff --git a/docs/toc.yml b/docs/toc.yml index e9f35f2059..2944df816d 100644 --- a/docs/toc.yml +++ b/docs/toc.yml @@ -626,3 +626,5 @@ items: href: requirement-sets/common/ribbon-api-requirement-sets.md - name: Shared Runtime requirement sets href: requirement-sets/common/shared-runtime-requirement-sets.md + - name: Task Pane API requirement sets + href: requirement-sets/common/task-pane-api-requirement-sets.md From 5590b27b2f1f75f7b7f441659c9b9f1f6948cd54 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Wed, 24 Sep 2025 13:50:46 -0700 Subject: [PATCH 2/2] Add supported build number --- .../common/task-pane-api-requirement-sets.md | 6 ++++-- docs/requirement-sets/requirement-sets.md | 8 ++++---- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/requirement-sets/common/task-pane-api-requirement-sets.md b/docs/requirement-sets/common/task-pane-api-requirement-sets.md index 24f11499aa..3ec4cc7cef 100644 --- a/docs/requirement-sets/common/task-pane-api-requirement-sets.md +++ b/docs/requirement-sets/common/task-pane-api-requirement-sets.md @@ -12,11 +12,13 @@ Requirement sets are named groups of API members. Office Add-ins use requirement With the Task Pane API requirement set, you can manage the task pane of an add-in. For example, you can change the width of an add-in's task pane. -Office Add-ins run across multiple versions of Office. The following table lists the Task Pane API requirement sets, its supported Office client applications, and the minimum builds or versions for those applications, where applicable. +## Support + +`TaskPaneApi 1.1` is available with **Excel** and **Word**. The following table lists the Task Pane API requirement sets, its supported Office client applications, and the minimum builds or versions for those applications, where applicable. | Requirement set | Office on the web | Office on Windows | Office on Mac | Office on iOS | Outlook on Android | |:-----|:-----|:-----|:-----|:-----|:-----| -| TaskPaneApi 1.1 | | //TODO | Not supported | Not supported | Not supported | +| TaskPaneApi 1.1 | Supported | Version 2507 (Build 19029.20004) | Not supported | Not supported | Not supported | ## Office Common API requirement sets diff --git a/docs/requirement-sets/requirement-sets.md b/docs/requirement-sets/requirement-sets.md index 527324d91b..620c5cedfa 100644 --- a/docs/requirement-sets/requirement-sets.md +++ b/docs/requirement-sets/requirement-sets.md @@ -21,8 +21,8 @@ To work as expected, your Office Add-in might depend on a specific Office applic |Platform|Extension points|Application-specific API requirement sets|[Common API requirement sets](common/office-add-in-requirement-sets.md)| |---|---|---|---| |Office on the web|||| -|Office on Windows (Microsoft 365 subscription)|||| -|Office on Windows
(retail perpetual Office 2016 and later)|||| +|Office on Windows (Microsoft 365 subscription)|||| +|Office on Windows
(retail perpetual Office 2016 and later)|||| |Office 2024 on Windows
(volume-licensed perpetual)|||| |Office 2021 on Windows
(volume-licensed perpetual)|||| |Office 2019 on Windows
(volume-licensed perpetual)|||| @@ -83,8 +83,8 @@ To work as expected, your Office Add-in might depend on a specific Office applic |Platform|Extension points|Application-specific API requirement sets|[Common API requirement sets](common/office-add-in-requirement-sets.md)| |---|---|---|---| |Office on the web|||| -|Office on Windows
(Microsoft 365 subscription)|||| -|Office on Windows
(retail perpetual Office 2016 and later)|||| +|Office on Windows
(Microsoft 365 subscription)|||| +|Office on Windows
(retail perpetual Office 2016 and later)|||| |Office 2024 on Windows
(volume-licensed perpetual)|||| |Office 2021 on Windows
(volume-licensed perpetual)|||| |Office 2019 on Windows
(volume-licensed perpetual)||||