diff --git a/README.md b/README.md
index 65509eb..ea77013 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,10 @@ import '@github/tab-container-element'
```
+### Events
+
+- `tab-container-change` (bubbles): fired on `` after a new tab is selected and visibility is updated. `event.detail.relatedTarget` is the newly visible tab panel.
+
## Browser support
Browsers without native [custom element support][support] require a [polyfill][].
diff --git a/examples/index.html b/examples/index.html
index d80c34d..d1472e1 100644
--- a/examples/index.html
+++ b/examples/index.html
@@ -23,7 +23,7 @@
-
+