diff --git a/README.md b/README.md
index 797d8e37..59ae8309 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,7 @@ Maintenance Status: Stable
 
 - [Installation](#installation)
 - [Browser Support](#browser-support)
+- [Caveats](#caveats)
 - [Projection support](#projection-support)
 - [Usage](#usage)
   - [`<script>` Tag](#script-tag)
@@ -51,7 +52,7 @@ Maintenance Status: Stable
   - [`debug`](#debug)
   - [`omnitone`](#omnitone)
   - [`omnitoneOptions`](#omnitoneoptions)
-  - [`disableTogglePlay`](#disableTogglePlay)
+  - [`disableTogglePlay`](#disabletoggleplay)
 - [Credits](#credits)
 - [Support](#support)
 
@@ -73,6 +74,9 @@ The most recent versions of:
   * Chrome on Android
   * Safari on iOS
 
+## Caveats
+* HLS captions on safari will not be visible as they are located inside of the shadowRoot in the video element and we cannot get access to them.
+
 ## Projection support
 Currently we only support:
 * Projections