# What changed in arboard

> 11 changes in arboard 2 to 3 from its official release notes, upgrade guides and advisories: 2 breaking, 5 new APIs and options. Each one cited. Sources checked 2026-11-12. HTML: https://unstale.sh/cargo/arboard/

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

## arboard 3

### Breaking changes

- `Error` is now marked as `#[non_exhaustive]`, so downstream code must account for future variants. (3.0.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.0.0)
- Platform-specific modules and clipboard structures were removed from the public API; use `arboard::Clipboard` and the new platform-specific extension traits instead. (3.0.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.0.0)

### New APIs and options

- Adds support for waiting for just one clipboard request. (3.7.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.7.0)
- Support for clearing the clipboard was added. (3.0.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.0.0)
- Support was added for excluding Windows clipboard data from clipboard history and OneDrive. (3.0.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.0.0)

### Performance

- Functions that previously accepted `String` now accept `Into<Cow<'a>, str>`, avoiding unnecessary string clones on platforms that can. (3.0.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.0.0)

### Behavior and default changes

- On X11 and Wayland, a write call can wait for another process to read clipboard data before returning. (3.0.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.0.0)

### Fixes and other changes

- A conversion failure error is returned when CGImageCreate fails. (3.7.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.7.0)
- URI-list MIME data is now properly encoded and decoded. (3.7.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v3.7.0)

## arboard 2

### New APIs and options

- Image operations are now an optional feature, allowing developers to choose whether to enable them. (2.0.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v2.0.0)
- Developers can select which Linux clipboard is used. (2.0.0) — [release notes](https://github.com/1Password/arboard/releases/tag/v2.0.0)
