# What changed in netlify-identity-widget

> 15 changes in netlify-identity-widget 2 from its official release notes, upgrade guides and advisories: 1 security, 4 new APIs and options. Each one cited. Sources checked 2026-10-21. HTML: https://unstale.sh/npm/netlify-identity-widget/

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

## netlify-identity-widget 2

### Security

- Restored sessions are validated server-side during initialization. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)

### New APIs and options

- Adds the cookieDomain option for cross-subdomain authentication. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)
- Facebook is added as an OAuth provider for the identity widget. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)
- The widget adds a toggle to show or hide passwords. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)
- Signup now supports custom user_metadata. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)

### Behavior and default changes

- Logged-in users see the recovery form instead of the logout screen. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)

### Tooling

- TypeScript support was added. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)

### Fixes and other changes

- The UMD entry now uses index.ts to auto-initialize the widget. (2.0.3) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.3)
- The netlify-identity-widget.js file is now exported properly. (2.0.1) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.1)
- The widget uses button elements for semantic markup. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)
- The close button size was fixed. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)
- A cookie path issue was fixed. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)
- A duplicate initialization guard issue was fixed. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)
- An ESC key issue was fixed. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)
- Seven translations were added: de, it, ar, zh-cn, nl, sv, and sw. (2.0.0) — [release notes](https://github.com/netlify/netlify-identity-widget/releases/tag/v2.0.0)