diff --git a/UPGRADE-6.0.md b/UPGRADE-6.0.md
new file mode 100644
index 00000000..b3b1c3fb
--- /dev/null
+++ b/UPGRADE-6.0.md
@@ -0,0 +1,16 @@
+# Upgrading to `bootstrap_form` 6.0
+
+Bootstrap 6 is fundamentally different from previous versions of Bootstrap, and therefore `bootstrap_form` is also fundamentally different.
+In addition, we've taken advantage of the major version change to implement new features in `bootstrap_form`
+that we hope will make this gem more useful.
+Many changes to your code are necessary if you're upgrading from previous versions of `bootstrap_form`.
+
+## Bootstrap 6 Changes
+
+Upgrading `bootstrap_form` to version 6 means you must upgrade your whole application to Bootstrap 6. Read the [Bootstrap 6 migration guide](https://getbootstrap.com/docs/6.0/guides/migration/) to see what changes in Bootstrap 6. This will also help you understand changes you will have to make to your `bootstrap_form` code.
+
+## `bootstrap_form` Version 6 Changes
+
+[Note to contributors: As you add to the `bootstrap-6` branch,
+remember to update this document
+if you change behaviour compared to earlier versions of `bootstrap_form`.]