diff --git a/README.md b/README.md
index ce593664..42e42b32 100644
--- a/README.md
+++ b/README.md
@@ -130,6 +130,34 @@ export default app;
 
 See [webpack.config.js](examples/webpack/webpack.config.js) in [examples/webpack](examples/webpack).
 
+#### Dynamic theming
+
+Use `carbon-components-svelte/css/all.css` for dynamic, client-side styling.
+
+Update the theme by setting the `theme` attribute on the `html` element. The default `theme` is `"white"`.
+
+```html
+<!DOCTYPE html>
+<html lang="en" theme="g10">
+  <body>
+    ...
+  </body>
+</html>
+```
+
+Using JavaScript:
+
+```svelte
+<script>
+  /** @type {"white" | "g10" | "g90" | "g100"} */
+  let theme = "white";
+
+  $: document.documentElement.setAttribute("theme", theme);
+</script>
+
+<button on:click="{() => theme = 'g90'}">Update theme</button>
+```
+
 ### TypeScript support
 
 [TypeScript definitions](types) are generated by [sveld](https://github.com/IBM/sveld).
