From 043a8f8d548d04473d289efbdd80ad4805c28ebd Mon Sep 17 00:00:00 2001
From: Jacek <jacek@clerk.dev>
Date: Fri, 20 Mar 2026 22:23:11 -0500
Subject: [PATCH] fix(vue): deprecate SignOutButton signOutOptions prop in
 favor of flat props

---
 .changeset/deprecate-vue-signout-options.md   | 5 +++++
 packages/vue/src/components/SignOutButton.vue | 8 ++++++++
 2 files changed, 13 insertions(+)
 create mode 100644 .changeset/deprecate-vue-signout-options.md

diff --git a/.changeset/deprecate-vue-signout-options.md b/.changeset/deprecate-vue-signout-options.md
new file mode 100644
index 00000000000..69f46f21240
--- /dev/null
+++ b/.changeset/deprecate-vue-signout-options.md
@@ -0,0 +1,5 @@
+---
+"@clerk/vue": patch
+---
+
+Deprecate the `signOutOptions` prop on `<SignOutButton />` in favor of top-level `redirectUrl` and `sessionId` props. The `signOutOptions` prop still works but now emits a deprecation warning.
diff --git a/packages/vue/src/components/SignOutButton.vue b/packages/vue/src/components/SignOutButton.vue
index e509f8c989e..a20b5642461 100644
--- a/packages/vue/src/components/SignOutButton.vue
+++ b/packages/vue/src/components/SignOutButton.vue
@@ -1,10 +1,14 @@
 <script setup lang="ts">
 import { useAttrs, useSlots } from 'vue';
+import { deprecated } from '@clerk/shared/deprecated';
 import type { SignOutOptions } from '@clerk/shared/types';
 import { useClerk } from '../composables/useClerk';
 import { assertSingleChild, normalizeWithDefaultValue } from '../utils';
 
 interface SignOutButtonProps {
+  /**
+   * @deprecated Use the `redirectUrl` and `sessionId` props directly instead.
+   */
   signOutOptions?: SignOutOptions;
   sessionId?: string;
   redirectUrl?: string;
@@ -22,6 +26,10 @@ function getChildComponent() {
 }
 
 function clickHandler() {
+  if (props.signOutOptions) {
+    deprecated('SignOutButton `signOutOptions`', 'Use the `redirectUrl` and `sessionId` props directly instead.');
+  }
+
   const signOutOptions: SignOutOptions = {
     redirectUrl: props.signOutOptions?.redirectUrl ?? props.redirectUrl,
     sessionId: props.signOutOptions?.sessionId ?? props.sessionId,