diff --git a/lib/Popper/Popper.js b/lib/Popper/Popper.js
index 4e119ef57..fcea7b500 100644
--- a/lib/Popper/Popper.js
+++ b/lib/Popper/Popper.js
@@ -18,6 +18,8 @@ export const AVAILABLE_PLACEMENTS = [
   'right-start',
   'right-end',
   'auto',
+  'auto-start',
+  'auto-end',
 ];
 
 const [DEFAULT_PLACEMENT] = AVAILABLE_PLACEMENTS;
diff --git a/lib/Popper/readme.md b/lib/Popper/readme.md
index 6f61be879..c772ec7a3 100644
--- a/lib/Popper/readme.md
+++ b/lib/Popper/readme.md
@@ -26,4 +26,7 @@ placement | string | Overlay placement. Available values: `auto`, `top`, `bottom
 portal | node | When is provided, overlay renders inside provided portal. | | |
 anchorRef | object | Reference to anchor element |  | yes |
 children | component | Component to be passed as an overlay |  | yes |
-modifiers | object | A set of modifications for extending popper functionality. For more details, please, go to https://popper.js.org/popper-documentation.html#modifiers. | | |
+modifiers | object | A set of modifications for extending popper functionality. For more details, please, [see the Popper.js docs](https://popper.js.org/docs/v1/#modifiers). | | |
+hideIfClosed | boolean | Hides the overlay if the popper is closed (via `display: none`), rather than removing it from the DOM entirely | false | |
+overlayProps | object | Props to add to the `<div>` used as the overlay | `{}` | |
+overlayRef | ref | Grabs a reference for the overlay `<div>` | | |