diff --git a/README.md b/README.md
index 1489c7418..56a53e2ed 100644
--- a/README.md
+++ b/README.md
@@ -523,6 +523,16 @@ example.passedElement.addEventListener('addItem', function(event) {
 
 **Usage:** Triggered when a user types into an input to search choices.
 
+### showDropdown
+**Arguments:** - **Input types affected:** `select-one`, `select-multiple`
+
+**Usage:** Triggered when the dropdown is shown.
+
+### hideDropdown
+**Arguments:** - **Input types affected:** `select-one`, `select-multiple`
+
+**Usage:** Triggered when the dropdown is hidden.
+
 ## Methods
 Methods can be called either directly or by chaining: