diff --git a/docs/Using-Fleet/MDM-macOS-updates.md b/docs/Using-Fleet/MDM-macOS-updates.md
index dd0e3c194c..30f2be09d3 100644
--- a/docs/Using-Fleet/MDM-macOS-updates.md
+++ b/docs/Using-Fleet/MDM-macOS-updates.md
@@ -51,7 +51,7 @@ Step 2 (installing the update) always requires end user action.
Currently, end user macOS update reminders via Nudge don't support RSR versions (ex. "13.4.1 (a)").
-You can use custom MDM commands in Fleet to trigger built-in macOS update reminders for RSRs. Learn which MDM commands to use in the Apple docs [here](https://support.apple.com/guide/deployment/rapid-security-responses-dep93ff7ea78/web).
+You can use custom MDM commands in Fleet to trigger built-in macOS update reminders for RSRs. Learn how [here](#end-user-macos-update-via-built-in-macos-notifications).
#### Mac is up to date
@@ -71,7 +71,92 @@ Sometimes after the end user clicks "update" on the Nudge window, the end user's
## End user macOS update via built-in macOS notifications
-Built-in macOS update reminders are available for all Fleet instances. To trigger these reminders, run the ["Schedule an OS update" MDM command](https://developer.apple.com/documentation/devicemanagement/schedule_an_os_update).
+Built-in macOS update reminders are available in Fleet Free and Fleet Premium.
+
+To trigger these reminders, we will do the following steps:
+
+1. Force a macOS update scan
+
+2. List available macOS updates
+
+3. Trigger macOS update reminder
+
+### Step 1: force a macOS update scan
+
+Use the request payload below when running a custom MDM command with Fleet. Documentation on how to run a custom command is [here](./MDM-commands#custom-commands).
+
+Request payload:
+
+```xml
+
+
+
+
+ Command
+
+ ForceUpdateScan
+
+ RequestType
+ ScheduleOSUpdateScan
+
+
+
+```
+
+### Step 2: list available macOS updates
+
+1. Run another custom MDM command using the request payload below.
+
+Request payload:
+
+```xml
+
+
+
+
+ Command
+
+ RequestType
+ AvailableOSUpdates
+
+
+
+```
+
+2. Copy the `ProductKey` from the command's results. Documentation on how to view a command's results is [here](./MDM-commands#step-4-view-the-commands-results).
+
+Example product key: `MSU_UPDATE_22F770820d_patch_13.4.1_rsr`
+
+### Step 3: trigger macOS update reminder
+
+Run another custom MDM command using the request payload below. Replace the product key with your product key.
+
+> This payload will trigger the "Install ASAP" behavior which displays a macOS notification with a 60 seconds timer before the Mac automatically restarts. The end user can dismiss the timer. To trigger different behavior, update the `InstallAction`. Options are documented by Apple [here](https://developer.apple.com/documentation/devicemanagement/scheduleosupdatecommand/command/updatesitem).
+
+Request payload:
+
+```yaml
+
+
+
+
+ Command
+
+ RequestType
+ ScheduleOSUpdate
+ Updates
+
+
+ InstallAction
+ InstallASAP
+ ProductKey
+ MSU_UPDATE_22F770820d_patch_13.4.1_rsr
+
+
+
+
+
+```