Skip to content

Commit 50a9895

Browse files
Revert "[All hosts] (event-based activation) Update Cache-Control header guidance" (#5465)
* Revert "[All hosts] (event-based activation) Update Cache-Control header guid…" This reverts commit 90bfe58. * Remove outdated information * Remove development guidance * Update ms.date * Revert change to attachments article
1 parent 1fb5241 commit 50a9895

File tree

3 files changed

+5
-10
lines changed

3 files changed

+5
-10
lines changed

docs/develop/add-in-manifests.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Office Add-ins manifest
33
description: Get an overview of the Office Add-in manifest and its uses.
44
ms.topic: overview
5-
ms.date: 11/06/2025
5+
ms.date: 10/10/2025
66
ms.localizationpriority: high
77
---
88

@@ -41,11 +41,7 @@ A manifest file enables an Office Add-in to do the following:
4141

4242
## Hosting requirements
4343

44-
The following URIs must support caching in production.
45-
- All image URIs, such as those used for [add-in commands](../design/add-in-commands.md).
46-
- The event-handling file of an [event-based activation](event-based-activation.md) add-in that runs in a JavaScript-only runtime.
47-
48-
The server hosting the image or event-handling file shouldn't return a `Cache-Control` header specifying `no-cache`, `no-store`, or similar options in the HTTP response.
44+
All image URIs, such as those used for [add-in commands](../design/add-in-commands.md), must support caching in production. The server hosting the image shouldn't return a `Cache-Control` header specifying `no-cache`, `no-store`, or similar options in the HTTP response.
4945

5046
All URLs to code or content files in the add-in should be **SSL-secured (HTTPS)**. [!INCLUDE [HTTPS guidance](../includes/https-guidance.md)]
5147

docs/develop/event-based-activation.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Activate add-ins with events
33
description: Learn how to develop an Office Add-in that implements event-based activation.
4-
ms.date: 11/06/2025
4+
ms.date: 10/28/2025
55
ms.topic: concept-article
66
ms.localizationpriority: medium
77
---
@@ -122,7 +122,6 @@ When developing an event-based add-in to run on a Windows client, be mindful of
122122

123123
Note that a large JavaScript bundle may cause issues with the performance of your add-in. We recommend preprocessing heavy operations, so that they're not included in your event-handling code.
124124
- When the JavaScript function specified in the manifest to handle an event runs, code in `Office.onReady()` and `Office.initialize` isn't run. We recommend adding any startup logic needed by event handlers, such as checking the user's client version, to the event handlers instead.
125-
- The event-handling file and the **bundle.js** file must support caching in production. The server hosting these files shouldn't return a `Cache-Control` header specifying `no-cache` or similar options in the HTTP response. For more information, see the "Hosting requirements" section of [Office Add-ins manifest](add-in-manifests.md#hosting-requirements).
126125

127126
### Event-based add-in limitations in Excel, PowerPoint, and Word
128127

docs/testing/troubleshoot-event-based-and-spam-reporting-add-ins.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Troubleshoot event-based and spam-reporting add-ins
33
description: Learn how to troubleshoot development errors in Office Add-ins that implement event-based activation or integrated spam reporting.
4-
ms.date: 11/06/2025
4+
ms.date: 10/14/2025
55
ms.topic: troubleshooting
66
ms.localizationpriority: medium
77
---
@@ -28,7 +28,7 @@ As you develop your [event-based](../develop/event-based-activation.md) or [spam
2828
- Verify that the `<Runtimes>` element (add-in only manifest) or `"extensions.runtimes.code"` property (unified manifest) correctly references the HTML or JavaScript file containing the event handlers. Classic Outlook on Windows and other Windows-based Office applications use the JavaScript file during runtime, while Office on the web, the new Outlook Mac UI, and [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) use the HTML file. For an example of how this is configured in the manifest, see the "Configure the manifest" section of [Automatically set the subject of a new message or appointment](../outlook/on-new-compose-events-walkthrough.md#configure-the-manifest).
2929

3030
For Windows clients (except for new Outlook on Windows), you must bundle all your event-handling JavaScript code into this JavaScript file referenced in the manifest. Note that a large JavaScript bundle may cause issues with the performance of your add-in. We recommend preprocessing heavy operations, so that they're not included in your event-handling code.
31-
- For the JavaScript-only runtime, the event-handling file and the **bundle.js** file must support caching in production. The server hosting these files shouldn't return a `Cache-Control` header specifying `no-cache` or similar options in the HTTP response. If caching is preventing you from seeing your changes during testing, try [clearing your cache](clear-cache.md#clear-the-office-cache-on-windows).
31+
3232
- For Windows clients (except for new Outlook on Windows), when the JavaScript function specified in the manifest to handle an event runs, code in `Office.onReady()` and `Office.initialize` isn't run. We recommend adding any startup logic needed by event handlers, such as checking the user's client version, to the event handlers instead.
3333

3434
- Verify that your event-handling JavaScript file calls `Office.actions.associate`. This ensures that the event handler name specified in the manifest is mapped to its JavaScript counterpart. The following code is an example.

0 commit comments

Comments
 (0)