diff --git a/packages/docs/src/en/plugins/trap.md b/packages/docs/src/en/plugins/trap.md
index 94700fa52..2464c9a35 100644
--- a/packages/docs/src/en/plugins/trap.md
+++ b/packages/docs/src/en/plugins/trap.md
@@ -178,3 +178,76 @@ Here is nesting in action:
+
+
+## Modifiers
+
+
+### .inert
+
+When building things like dialogs/modals, it's recommended to hide all the other elements on the page from screenreaders when trapping focus.
+
+By adding `.inert` to `x-trap`, when focus is trapped, all other elements on the page will receive `aria-hidden="true"` attributes, and when focus trapping is disabled, those attributes will also be removed.
+
+```alpine
+
+
+
+ ...
+
+
+
+ ...
+
+
+
+
+
+
+ ...
+
+
+
+ ...
+
+
+```
+
+
+### .noscroll
+
+When building dialogs/modals with Alpine, it's recommended that you disable scrollling for the surrounding content when the dialog is open.
+
+`x-trap` allows you to do this automatically with the `.noscroll` modifiers.
+
+By adding `.noscroll`, Alpine will remove the scrollbar from the page and block users from scrolling down the page while a dialog is open.
+
+For example:
+
+```alpine
+
+
+
+
+ Dialog Contents
+
+
+
+
+```
+
+
+
+
+
+
+
+
Dialog Contents
+
+
Notice how you can no longer scroll on this page while this dialog is open.