Skip to content

Commit 37bd198

Browse files
[All hosts] (Yeoman) Add note about workaround to sign in (#5161)
1 parent 511d15b commit 37bd198

File tree

6 files changed

+17
-7
lines changed

6 files changed

+17
-7
lines changed

docs/includes/alert-use-https.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,5 @@
55
> - If this is your first time developing an Office Add-in on your machine, you may be prompted in the command line to grant Microsoft Edge WebView a loopback exemption ("Allow localhost loopback for Microsoft Edge WebView?"). When prompted, enter `Y` to allow the exemption. Note that you'll need administrator privileges to allow the exemption. Once allowed, you shouldn't be prompted for an exemption when you sideload Office Add-ins in the future (unless you remove the exemption from your machine). To learn more, see ["We can't open this add-in from localhost" when loading an Office Add-in or using Fiddler](/office/troubleshoot/office-suite-issues/cannot-open-add-in-from-localhost).
66
>
77
> :::image type="content" source="../images/office-loopback-exemption.png" alt-text="The prompt in the command line to allow Microsoft Edge WebView a loopback exemption.":::
8+
>
9+
> - When you first use Yeoman generator to develop an Office Add-in, your default browser opens a window where you'll be prompted to sign in to your Microsoft 365 account. If a sign-in window doesn't appear and you encounter a sideloading or login timeout error, run `teamsapp auth login m365`.
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,5 @@
11
> [!NOTE]
2+
>
3+
> - When you first use Yeoman generator to develop an Office Add-in, your default browser opens a window where you'll be prompted to sign in to your Microsoft 365 account. If a sign-in window doesn't appear and you encounter a sideloading or login timeout error, run `teamsapp auth login m365` before running `npm start` again.
4+
>
25
> If your add-in wasn't automatically sideloaded, follow the instructions in [Sideload Outlook add-ins for testing](../outlook/sideload-outlook-add-ins-for-testing.md#sideload-manually) to manually sideload the add-in in Outlook.

docs/outlook/contextless.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -214,8 +214,7 @@ To activate your add-in with the Reading Pane turned off or without a message se
214214
npm start
215215
```
216216

217-
> [!TIP]
218-
> If your add-in doesn't automatically sideload, follow the instructions in [Sideload Outlook add-ins for testing](sideload-outlook-add-ins-for-testing.md#sideload-manually) to manually sideload it in Outlook.
217+
[!INCLUDE [outlook-manual-sideloading](../includes/outlook-manual-sideloading.md)]
219218

220219
1. Navigate to your inbox and do one of the following:
221220

docs/outlook/item-multi-select.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -337,8 +337,7 @@ The following example implements the `getSelectedItemsAsync` and `loadItemByIdAs
337337
npm start
338338
```
339339

340-
> [!TIP]
341-
> If your add-in doesn't automatically sideload, follow the instructions in [Sideload Outlook add-ins for testing](sideload-outlook-add-ins-for-testing.md#sideload-manually) to manually sideload it in Outlook.
340+
[!INCLUDE [outlook-manual-sideloading](../includes/outlook-manual-sideloading.md)]
342341

343342
1. In Outlook, ensure the Reading Pane is enabled. To enable the Reading Pane, see [Use and configure the Reading Pane to preview messages](https://support.microsoft.com/office/2fd687ed-7fc4-4ae3-8eab-9f9b8c6d53f0).
344343

docs/outlook/sideload-outlook-add-ins-for-testing.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Sideload Outlook add-ins for testing
33
description: Use sideloading to install an Outlook add-in for testing without having to first put it in an add-in catalog.
4-
ms.date: 02/12/2025
4+
ms.date: 05/06/2025
55
ms.topic: how-to
66
ms.localizationpriority: medium
77
---
@@ -30,6 +30,9 @@ If you created your Outlook add-in using the [Yeoman generator for Office Add-in
3030
3131
1. Open a command prompt and navigate to the root directory of your Yeoman generated add-in project. Run the command `npm start`.
3232

33+
> [!TIP]
34+
> When you first use Yeoman generator to develop an Office Add-in, your default browser opens a window where you'll be prompted to sign in to your Microsoft 365 account. If a sign-in window doesn't appear and you encounter a sideloading or login timeout error, run `teamsapp auth login m365` before running `npm start` again.
35+
3336
1. Your Outlook add-in will automatically sideload to Outlook on your desktop computer. You'll see a dialog appear, stating there is an attempt to sideload the add-in, listing the name and the location of the manifest file. Select **OK**, which will register the manifest.
3437

3538
> [!IMPORTANT]

docs/quickstarts/excel-quickstart-jquery.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,9 @@ The Office Add-ins Development Kit will create the project. It will then open th
3838
[!include[Dev_kit_stop_debugging](../includes/dev-kit-stop-debugging.md)]
3939

4040
[!include[Dev_kit_troubleshooting](../includes/dev-kit-troubleshooting.md)]
41+
4142
# [Yeoman generator](#tab/yeoman)
43+
4244
## Prerequisites
4345

4446
[!include[Yeoman generator prerequisites](../includes/quickstart-yo-prerequisites.md)]
@@ -82,12 +84,14 @@ After you complete the wizard, the generator creates the project and installs su
8284
8385
1. [!include[Instructions to stop web server and uninstall dev add-in](../includes/stop-uninstall-dev-add-in.md)]
8486
87+
[!include[The common troubleshooting section for all Yo Office quick starts](../includes/quickstart-troubleshooting-yo.md)]
88+
89+
---
90+
8591
## Next steps
8692
8793
Congratulations, you've successfully created an Excel task pane add-in! Next, learn more about the capabilities of an Excel add-in and build a more complex add-in by following along with the [Excel add-in tutorial](../tutorials/excel-tutorial.md).
8894
89-
[!include[The common troubleshooting section for all Yo Office quick starts](../includes/quickstart-troubleshooting-yo.md)]
90-
9195
## Code samples
9296
9397
- [Excel "Hello world" add-in](https://github.com/OfficeDev/Office-Add-in-samples/tree/main/Samples/hello-world/excel-hello-world): Learn how to build a simple Office Add-in with only a manifest, HTML web page, and a logo.

0 commit comments

Comments
 (0)