diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2f3745a5..71d6337b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- ## Unreleased -->
 
+## [0.31.0](https://github.com/IBM/carbon-components-svelte/releases/tag/v0.31.0) - 2021-03-20
+
+**Breaking Changes**
+
+- remove default `title` value in `InlineNotification`
+- remove default `title`, `caption` values in `ToastNotification`
+- remove `iconDescription` prop from `HeaderNavMenu`
+
+**Features**
+
+- add `Popover` component
+- add `ContextMenu` component
+- add "container" type for `TabsSkeleton`
+- add warning state to `Select`
+- dispatch "on:click:button--next" and "on:click:button--previous" in `Pagination`
+
+**Fixes**
+
+- replace chevron icons with "Add" and "Subtract" icons in `NumberInput`
+- fix `Slider` markup to use CSS to hide input if `hideTextInput` is `true`
+- remove hotfix inline style to center dropdown chevron
+- add "rowgroup" role to `StructuredListBody`
+- fix type definition for `MultiSelect`: "clear" should be typed as a custom event
+- remove line breaks in anchor element in `Link`
+- only set `autofocus` attribute if the value is `true`
+
+**Documentation**
+
+- add `Slider` hidden text input, invalid, disabled examples
+- add `Select` warning, invalid, helper text, skeleton (hidden label) examples
+- add `RadioButton` disabled buttons example
+- update sample copy in `ToastNotification`, `InlineNotification`
+- update `Select` item groups example to use the hidden default option
+
+**Housekeeping**
+
+- upgrade `carbon-components` to version 10.31.0
+- upgrade `carbon-icons-svelte` to version 10.27.0 (icons are correctly typed using `SvelteComponentTyped`)
+
 ## [0.30.0](https://github.com/IBM/carbon-components-svelte/releases/tag/v0.30.0) - 2021-03-13
 
 **Breaking Changes**
diff --git a/COMPONENT_INDEX.md b/COMPONENT_INDEX.md
index b24deab3..dd0c5bab 100644
--- a/COMPONENT_INDEX.md
+++ b/COMPONENT_INDEX.md
@@ -1,6 +1,6 @@
 # Component Index
 
-> 166 components exported from carbon-components-svelte@0.30.0.
+> 166 components exported from carbon-components-svelte@0.31.0.
 
 ## Components
 
diff --git a/package.json b/package.json
index cf270e9c..e9e3903d 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "carbon-components-svelte",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "license": "Apache-2.0",
   "author": "IBM",
   "description": "Svelte implementation of the Carbon Design System",
diff --git a/preprocess/api.json b/preprocess/api.json
index 1fa52b1b..5b3a5d79 100644
--- a/preprocess/api.json
+++ b/preprocess/api.json
@@ -1,5 +1,5 @@
 {
-  "version": "0.30.0",
+  "version": "0.31.0",
   "components": {
     "Accordion": {
       "path": "carbon-components-svelte/src/Accordion/Accordion.svelte"
@@ -67,6 +67,21 @@
     "Switch": {
       "path": "carbon-components-svelte/src/ContentSwitcher/Switch.svelte"
     },
+    "ContextMenu": {
+      "path": "carbon-components-svelte/src/ContextMenu/ContextMenu.svelte"
+    },
+    "ContextMenuDivider": {
+      "path": "carbon-components-svelte/src/ContextMenu/ContextMenuDivider.svelte"
+    },
+    "ContextMenuGroup": {
+      "path": "carbon-components-svelte/src/ContextMenu/ContextMenuGroup.svelte"
+    },
+    "ContextMenuOption": {
+      "path": "carbon-components-svelte/src/ContextMenu/ContextMenuOption.svelte"
+    },
+    "ContextMenuRadioGroup": {
+      "path": "carbon-components-svelte/src/ContextMenu/ContextMenuRadioGroup.svelte"
+    },
     "Copy": {
       "path": "carbon-components-svelte/src/Copy/Copy.svelte"
     },
@@ -274,6 +289,9 @@
     "PaginationOverflow": {
       "path": "carbon-components-svelte/src/PaginationNav/PaginationOverflow.svelte"
     },
+    "Popover": {
+      "path": "carbon-components-svelte/src/Popover/Popover.svelte"
+    },
     "ProgressIndicator": {
       "path": "carbon-components-svelte/src/ProgressIndicator/ProgressIndicator.svelte"
     },