[Moved] Office Add-in Commands Samples
This sample moved to the Office Add-in samples repo
Note: This repo is archived and no longer actively maintained. Security vulnerabilities may exist in the project, or its dependencies. If you plan to reuse or run any code from this repo, be sure to perform appropriate security checks on the code or dependencies first. Do not use this project as the starting point of a production Office Add-in. Always start your production code by using the Office/SharePoint development workload in Visual Studio, or the Yeoman generator for Office Add-ins, and follow security best practices as you develop the add-in.
Overview
Add-in commands enable developers to extend the Office user interface such as the Office Ribbon to create awesome, efficient to use add-ins. Watch this channel9 video for a complete overview. The examples in this repo show you how to use add-in commands in Excel, Word and PowerPoint add-ins. If you are looking for information about commands for Outlook head to http://dev.outlook.com
Here is how the samples look when running:
Custom Tab (Simple Example)
Excel
Word
PowerPoint
Quick Start
Step 1. Setup your environment
-
Office Desktop: Ensure that you have the latest version of Office installed. Add-in commands require build 16.0.6769.0000 or higher (16.0.6868.0000 recommended). Learn how to Install the latest version of Office applications.
-
Office Online: There is no additional setup. Please note that support for commands in Office Online for work/school accounts is in preview.
-
Office for Mac: Ensure that you have build 15.33+
Step 2. Create and validate your manifest
We strongly recommend you to use one of our sample manifests as a starting point, the Simple example is a good one to get going. Once you make it work then you can start making small modifications and test your changes often. If you make modifications, use the Manifest reference as a guide. You can also validate your xml using the Office Add-in Validator **. For Office Windows clients you can also use Runtime Logging to debug your manifest.
You can also use the latest Visual Studio Tools to create and debug your add-in. See next step.
Step 3. Deploy add-in manifest and test the add-in
To test your add-in you must register it with Office. Two methods are currently supported:
Sideload directly to the client
-
Office Desktop. Sideload your add-in via a network share.
- Once sideloaded, go to
Insert>My Add-ins>Shared Folder
and click theRefresh
button to ensure the Add-in shows. Do this any time you need to refresh your Ribbon.
- Once sideloaded, go to
-
Office Online. Open the Add-ins dialog via
Insert>Office Add-ins
then select[Manage My Add-ins]>Upload My Add-in
and upload the manifest file you want to test. To remove a sideloaded add-in you have to clear your HTML LocalStorage -
Office for Mac. Sideload your add-in on the Mac
- Once sideloaded, goto
Insert>Office Add-ins
and click on the add-in to install it.
- Once sideloaded, goto
Visual Studio F5
- Make sure you have at least version 16.0.6868.0000 of Office for Windows installed.
- Make sure you have the latest Visual Studio tools.
Once you have the latest, the new VS templates include support for add-in commands. You can also deploy your add-ins to Windows Desktop clients using F5.
Documentation
Join the Microsoft 365 Developer Program
Get a free sandbox, tools, and other resources you need to build solutions for the Microsoft 365 platform.
- Free developer sandbox Get a free, renewable 90-day Microsoft 365 E5 developer subscription.
- Sample data packs Automatically configure your sandbox by installing user data and content to help you build your solutions.
- Access to experts Access community events to learn from Microsoft 365 experts.
- Personalized recommendations Find developer resources quickly from your personalized dashboard.
This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.