# What changed in ics

> 7 changes in ics 3 from its official release notes, upgrade guides and advisories: 3 new APIs and options. Each one cited. Sources checked 2026-10-20. HTML: https://unstale.sh/npm/ics/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## ics 3

### New APIs and options

- Adds support for SCHEDULE-AGENT. (3.11.0) — [release notes](https://github.com/adamgibbons/ics/releases/tag/v3.11.0)
- Added RECURRENCE-ID support for creating calendar events. (3.10.0) — [release notes](https://github.com/adamgibbons/ics/releases/tag/v3.10.0)
- Adds an async version of createEvents that periodically yields. (3.9.0) — [release notes](https://github.com/adamgibbons/ics/releases/tag/v3.9.0)

### Behavior and default changes

- METHOD can now be omitted. (3.12.0) — [release notes](https://github.com/adamgibbons/ics/releases/tag/v3.12.0)

### Fixes and other changes

- Special characters in VALARM summary and description are escaped as TEXT, so these values are handled correctly. (3.12.1) — [release notes](https://github.com/adamgibbons/ics/releases/tag/v3.12.1)
- Fixes NaN validation in dateTimeSchema. (3.12.0) — [release notes](https://github.com/adamgibbons/ics/releases/tag/v3.12.0)
- Corrected the wrong ReturnObject type annotation. (3.9.1) — [release notes](https://github.com/adamgibbons/ics/releases/tag/v3.9.1)
