From 97c41ce0c577a113b8a4a89035737f0bebece67c Mon Sep 17 00:00:00 2001
From: Alessio Gravili <alessio@gravili.de>
Date: Wed, 27 Aug 2025 18:32:06 -0700
Subject: [PATCH] refactor: deprecate job queue runHooks property (#13617)

Setting `runHooks: true` is already discouraged and will make the job
queue system a lot slower and less reliable. We have no test coverage
for this and it's additional code we need to maintain.

To further discourage using this property, this PR marks it as
deprecated and for removal in 4.0.
---
 packages/payload/src/queues/config/types/index.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/payload/src/queues/config/types/index.ts b/packages/payload/src/queues/config/types/index.ts
index e3363687a..6c07ca47a 100644
--- a/packages/payload/src/queues/config/types/index.ts
+++ b/packages/payload/src/queues/config/types/index.ts
@@ -157,6 +157,7 @@ export type JobsConfig = {
    * drastically affect performance.
    *
    * @default false
+   * @deprecated - this will be removed in 4.0
    */
   runHooks?: boolean
   /**