diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..7339931
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,123 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [3.0.0] - 2024-02-19
+
+**BREAKING**: Config syntax changes, see readme for new syntax but in short
+`wm_property` is no longer, and have been replaced by scoped aliases that are
+checked in this order:
+```toml
+[aliases.name] # 1
+".*mutt$" = "Mutt"
+
+[aliases.instance] # 2
+"open.spotify.com" = "Spotify"
+
+[aliases.class] # 3
+"^firefoxdeveloperedition$" = "Firefox-dev"
+```
+
+If there are no alias defined, `i3wsr` will default class, but this can be
+configured with
+```
+--display-property=[class|instance|name]`
+```
+or config file:
+
+```toml
+[general]
+display_property = "instance" # class, instance, name
+```
+
+### Bug Fixes
+
+- Missing instance in class string
+- Remove old file from package exclude
+- Tests, update connection namespace
+- Clean cache on vagrant machine
+- Format source files using rustfmt
+- Refresh lock file
+- License year to current
+- Ignore scratch buffer
+- Tests
+- Handle no alias by adding display_prop conf
+- Add display property as a cmd opt
+
+### Documentation
+
+- Fix readme url (after branch rename)
+- Update instance explanation
+- Update toc
+- Document aliases usage
+- Update readme and example config
+- Fix badge, update toc, fix section placement
+- Fix typo
+
+### Features
+
+- Update casing etc for error msg
+- Add split_at option
+- [**breaking**] Enable wm_property scoped aliases
+- Add empty_label option
+
+### Miscellaneous Tasks
+
+- Add test workflow, update scripts
+- Update test branch
+- Fix job name
+- Remove old travis conf
+- Remove leftover cmd opt
+
+### Refactor
+
+- Rewrite failure logic
+- Remove lazy_static
+- Move i3ipc to dependency section
+- Remove unneeded extern declarations
+- Update clap, rewrite args parsing
+- Move cmd arg parsing to new setup fn
+- Replace xcb with i3ipc window_properties
+
+### Styling
+
+- Rustfmt
+
+### Testing
+
+- Update ubuntu version
+- Fix tests after failure refactor
+
+### Deps
+
+- Update to latest version of xcb
+- Update toml (0.7.6)
+- Update serde (1.0.171)
+- Update itertools (0.11.0)
+- Pin regex to 1.9.1
+- Pin endoing to 0.2.33
+
+## [2.1.1] - 2022-03-15
+
+### Bug Fixes
+
+- Use with_context() instead of context()
+
+## [2.1.0] - 2022-03-14
+
+### Bug Fixes
+
+- Build warnings
+
+### Documentation
+
+- Add examples of workspace assignment
+- Document about the default config file
+
+## [1.0.0] - 2017-12-19
+
+### WIP
+
+- Attempt to use xlib FFI to get win props
+
+<!-- generated by git-cliff -->