diff --git a/docs/src/content/docs/reference/safe-outputs.md b/docs/src/content/docs/reference/safe-outputs.md
index ef9b863881..32b548d582 100644
--- a/docs/src/content/docs/reference/safe-outputs.md
+++ b/docs/src/content/docs/reference/safe-outputs.md
@@ -637,6 +637,19 @@ safe-outputs:
     expires: 14                   # auto-close after 14 days (same-repo only)
     if-no-changes: "warn"         # "warn" (default), "error", or "ignore"
     target-repo: "owner/repo"     # cross-repository
+    base-branch: "vnext"          # target branch for PR (default: github.ref_name)
+```
+
+The `base-branch` field specifies which branch the pull request should target. This is particularly useful for cross-repository PRs where you need to target non-default branches (e.g., `vnext`, `release/v1.0`, `staging`). When not specified, defaults to the workflow's branch (`github.ref_name`).
+
+**Example use case:** A workflow in `org/engineering` that creates PRs in `org/docs` targeting the `vnext` branch for feature documentation:
+
+```yaml wrap
+safe-outputs:
+  create-pull-request:
+    target-repo: "org/docs"
+    base-branch: "vnext"
+    draft: true
 ```
 
 > [!NOTE]