# office-addin-usage-data

> Provides infrastructure to send usage data events and exceptions.

Latest version **3.0.0** (published 2026-09-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install office-addin-usage-data
pnpm add office-addin-usage-data
yarn add office-addin-usage-data
bun add office-addin-usage-data
```

Provides the command `office-addin-usage-data`.

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2026-09-09 |
| First published | 2019-08-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 53.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 194 |
| Author | Office Dev |
| Maintainers | ms-office |
| Keywords | Office, Office Add-in |

## Links

- npm: https://www.npmjs.com/package/office-addin-usage-data
- Repository: https://github.com/OfficeDev/Office-Addin-Scripts
- Homepage: https://github.com/OfficeDev/Office-Addin-Scripts#readme
- Issues: https://github.com/OfficeDev/Office-Addin-Scripts/issues
- npm.io page: https://npm.io/package/office-addin-usage-data

## Dependencies (1)

- [commander](https://npm.io/package/commander.md) ^13.0.0

## Recent versions

- 3.0.0 (latest) — 2026-09-09
- 2.1.1 — 2026-07-06
- 2.1.0 — 2026-05-19
- 2.0.8 — 2026-04-24
- 2.0.7 — 2026-04-06
- 2.0.6 — 2025-11-09
- 2.0.5 — 2025-11-04
- 2.0.4 — 2025-05-09
- 2.0.3 — 2025-02-03
- 2.0.2 — 2025-01-16
- 2.0.1 — 2024-12-13
- 2.0.0 — 2024-10-30
- 1.6.14 — 2024-09-27
- 1.6.13 — 2024-09-09
- 1.6.12 — 2024-06-17
- … 57 more at https://npm.io/package/office-addin-usage-data/versions

## README

# Office-Addin-Usage-Data
This package allows for reporting usage data events and exception data to the selected telemetry infrastructure (e.g. ApplicationInsights).

# Privacy
The Office-Addin-Usage-Data package collects anonymized usage data and sends it to Microsoft. For more details on how we use this data and under what circumstances it may be shared, 
please see the [Microsoft privacy statement](https://privacy.microsoft.com/en-us/privacystatement).

The package collects:
* Usage data about operations performed.
* Exception call stacks to help diagnose issues.


## Command-Line Interface
* [List](#List)
* [Off](#Off)
* [On](#On)

### List
Display the current usage data settings.

Syntax:

`list`

#

### Off
Sets the usage data level to Off(sending no usage data data).

Syntax:

`off`

#

### On
Sets the usage data level to On(sending usage and exception data).

Syntax:

`on`

#

---
_Source: https://npm.io/package/office-addin-usage-data · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._