diff --git a/docs/migration/alpha-beta.md b/docs/migration/alpha-beta.md
index 67a4241759f..75a9be2f4bd 100644
--- a/docs/migration/alpha-beta.md
+++ b/docs/migration/alpha-beta.md
@@ -6,11 +6,12 @@
| Name | Description | Action |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 🔄 renamed `Tonality` to `Density` | class names and data-attributes changed from
`.db-ui-#{$tonality},[data-tonality="#{$tonality}"] {` to
`.db-ui-#{density},[data-density="#{density}"] {` | search `tonality` & replace with `density` |
+| 🔄 renamed `Tonality` to `Density` | class names and data-attributes changed from
`.db-ui-#{$tonality},[data-tonality="#{$tonality}"] {` to
`.db-#{density},[data-density="#{density}"] {` | search `tonality` & replace with `density` |
| ❌ removed `opacity` tokens | we use only 1 opacity (0.4) for all components | If you use some of the tokens like `--db-opacity-sm` you might run into issues with your layout |
| 🔄 updated `border` tokens | we add all shirt-sizes `3xs`-`3xl` as tokens | If you use some of the tokens like `db-border-height-sm` you might run into issues with your layout, because the values behind it changed |
| 🔄 moved `_font-sizes.scss` | We moved the file to another folder to align the same structure as icons or colors. We add `css` classes, you can use them by importing `@db-ui/foundations/scss/fonts/classes/all.css` | If you use some placeholder like `%db-overwrite-font-size-sm` you might need to import the `_font-sizes.scss` like this: `@use "@db-ui/foundations/build/scss/fonts";` |
| 🔄 ❗ refactored `colors` | All colors changed. We use color-palettes to generate speaking-names (check `@db-ui/foundations/scss/colors/_variables.scss` to see a list of available tokens). We removed `base` color, it was the same like `neutral`. Add different background level. | 1. Replace all `base` colors with `neutral`
2. If you use the color class replace `db-bg-x` with `db-x-bg-lvl-1`
3. Replace `border-strong`/ `border-weak` tokens with `contrast-high`/`contrast-low` |
+| 🔄 renamed timing variables | renamed `$db-transition-emotional-timing` to `$db-transition-timing-emotional` / `--db-transition-emotional-timing` to `--db-transition-timing-emotional` | Replace `transition-emotional-timing` by `transition-timing-emotional` |
### Internal