payloadcms · PatrikKozak · Jun 2, 2025 · Jun 2, 2025 · Jun 2, 2025 · Jun 2, 2025
diff --git a/packages/graphql/src/resolvers/collections/delete.ts b/packages/graphql/src/resolvers/collections/delete.ts
@@ -11,6 +11,7 @@ export type Resolver<TSlug extends CollectionSlug> = (
     fallbackLocale?: string
     id: number | string
     locale?: string
+    trash?: boolean
   },
   context: {
     req: PayloadRequest
@@ -49,6 +50,7 @@ export function getDeleteResolver<TSlug extends CollectionSlug>(
       collection,
       depth: 0,
       req: isolateObjectProperty(req, 'transactionID'),
+      trash: args.trash,
     }
 
     const result = await deleteByIDOperation(options)

diff --git a/packages/graphql/src/resolvers/collections/find.ts b/packages/graphql/src/resolvers/collections/find.ts
@@ -15,6 +15,7 @@ export type Resolver = (
     page?: number
     pagination?: boolean
     sort?: string
+    trash?: boolean
     where?: Where
   },
   context: {
@@ -57,6 +58,7 @@ export function findResolver(collection: Collection): Resolver {
       pagination: args.pagination,
       req,
       sort: args.sort,
+      trash: args.trash,
       where: args.where,
     }
 

diff --git a/packages/graphql/src/resolvers/collections/findByID.ts b/packages/graphql/src/resolvers/collections/findByID.ts
@@ -11,6 +11,7 @@ export type Resolver<TData> = (
     fallbackLocale?: string
     id: string
     locale?: string
+    trash?: boolean
   },
   context: {
     req: PayloadRequest
@@ -50,6 +51,7 @@ export function findByIDResolver<TSlug extends CollectionSlug>(
       depth: 0,
       draft: args.draft,
       req: isolateObjectProperty(req, 'transactionID'),
+      trash: args.trash,
     }
 
     const result = await findByIDOperation(options)

diff --git a/packages/graphql/src/resolvers/collections/findVersionByID.ts b/packages/graphql/src/resolvers/collections/findVersionByID.ts
@@ -10,6 +10,7 @@ export type Resolver<T extends TypeWithID = any> = (
     fallbackLocale?: string
     id: number | string
     locale?: string
+    trash?: boolean
   },
   context: {
     req: PayloadRequest
@@ -33,6 +34,7 @@ export function findVersionByIDResolver(collection: Collection): Resolver {
       collection,
       depth: 0,
       req: isolateObjectProperty(req, 'transactionID'),
+      trash: args.trash,
     }
 
     const result = await findVersionByIDOperation(options)

diff --git a/packages/graphql/src/resolvers/collections/findVersions.ts b/packages/graphql/src/resolvers/collections/findVersions.ts
@@ -14,6 +14,7 @@ export type Resolver = (
     page?: number
     pagination?: boolean
     sort?: string
+    trash?: boolean
     where: Where
   },
   context: {
@@ -54,6 +55,7 @@ export function findVersionsResolver(collection: Collection): Resolver {
       pagination: args.pagination,
       req: isolateObjectProperty(req, 'transactionID'),
       sort: args.sort,
+      trash: args.trash,
       where: args.where,
     }
 

diff --git a/packages/graphql/src/resolvers/collections/update.ts b/packages/graphql/src/resolvers/collections/update.ts
@@ -13,6 +13,7 @@ export type Resolver<TSlug extends CollectionSlug> = (
     fallbackLocale?: string
     id: number | string
     locale?: string
+    trash?: boolean
   },
   context: {
     req: PayloadRequest
@@ -54,6 +55,7 @@ export function updateResolver<TSlug extends CollectionSlug>(
       depth: 0,
       draft: args.draft,
       req: isolateObjectProperty(req, 'transactionID'),
+      trash: args.trash,
     }
 
     const result = await updateByIDOperation<TSlug>(options)

diff --git a/packages/graphql/src/schema/initCollections.ts b/packages/graphql/src/schema/initCollections.ts
@@ -205,6 +205,7 @@ export function initCollections({ config, graphqlResult }: InitCollectionsGraphQ
                 locale: { type: graphqlResult.types.localeInputType },
               }
             : {}),
+          trash: { type: GraphQLBoolean },
         },
         resolve: findByIDResolver(collection),
       }
@@ -224,6 +225,7 @@ export function initCollections({ config, graphqlResult }: InitCollectionsGraphQ
           page: { type: GraphQLInt },
           pagination: { type: GraphQLBoolean },
           sort: { type: GraphQLString },
+          trash: { type: GraphQLBoolean },
         },
         resolve: findResolver(collection),
       }
@@ -292,6 +294,7 @@ export function initCollections({ config, graphqlResult }: InitCollectionsGraphQ
                 locale: { type: graphqlResult.types.localeInputType },
               }
             : {}),
+          trash: { type: GraphQLBoolean },
         },
         resolve: updateResolver(collection),
       }
@@ -300,6 +303,7 @@ export function initCollections({ config, graphqlResult }: InitCollectionsGraphQ
         type: collection.graphQL.type,
         args: {
           id: { type: new GraphQLNonNull(idType) },
+          trash: { type: GraphQLBoolean },
         },
         resolve: getDeleteResolver(collection),
       }
@@ -329,12 +333,12 @@ export function initCollections({ config, graphqlResult }: InitCollectionsGraphQ
         {
           name: 'createdAt',
           type: 'date',
-          label: 'Created At',
+          label: ({ t }) => t('general:createdAt'),
         },
         {
           name: 'updatedAt',
           type: 'date',
-          label: 'Updated At',
+          label: ({ t }) => t('general:updatedAt'),
         },
       ]
 
@@ -359,6 +363,7 @@ export function initCollections({ config, graphqlResult }: InitCollectionsGraphQ
                   locale: { type: graphqlResult.types.localeInputType },
                 }
               : {}),
+            trash: { type: GraphQLBoolean },
           },
           resolve: findVersionByIDResolver(collection),
         }
@@ -385,6 +390,7 @@ export function initCollections({ config, graphqlResult }: InitCollectionsGraphQ
             page: { type: GraphQLInt },
             pagination: { type: GraphQLBoolean },
             sort: { type: GraphQLString },
+            trash: { type: GraphQLBoolean },
           },
           resolve: findVersionsResolver(collection),
         }

diff --git a/packages/payload/src/collections/config/sanitize.ts b/packages/payload/src/collections/config/sanitize.ts
@@ -97,6 +97,7 @@ export const sanitizeCollection = async (
     // add default timestamps fields only as needed
     let hasUpdatedAt: boolean | null = null
     let hasCreatedAt: boolean | null = null
+    let hasDeletedAt: boolean | null = null
 
     sanitized.fields.some((field) => {
       if (fieldAffectsData(field)) {
@@ -107,9 +108,13 @@ export const sanitizeCollection = async (
         if (field.name === 'createdAt') {
           hasCreatedAt = true
         }
+
+        if (field.name === 'deletedAt') {
+          hasDeletedAt = true
+        }
       }
 
-      return hasCreatedAt && hasUpdatedAt
+      return hasCreatedAt && hasUpdatedAt && (!sanitized.softDeletes || hasDeletedAt)
     })
 
     if (!hasUpdatedAt) {
@@ -138,6 +143,19 @@ export const sanitizeCollection = async (
         label: ({ t }) => t('general:createdAt'),
       })
     }
+
+    if (sanitized.softDeletes && !hasDeletedAt) {
+      sanitized.fields.push({
+        name: 'deletedAt',
+        type: 'date',
+        admin: {
+          disableBulkEdit: true,
+          hidden: true,
+        },
+        index: true,
+        label: ({ t }) => t('general:deletedAt'),
+      })
+    }
   }
 
   sanitized.labels = sanitized.labels || formatLabels(sanitized.slug)

diff --git a/packages/payload/src/collections/config/types.ts b/packages/payload/src/collections/config/types.ts
@@ -67,7 +67,7 @@ export type AuthOperationsFromCollectionSlug<TSlug extends CollectionSlug> =
 
 export type RequiredDataFromCollection<TData extends JsonObject> = MarkOptional<
   TData,
-  'createdAt' | 'id' | 'sizes' | 'updatedAt'
+  'createdAt' | 'deletedAt' | 'id' | 'sizes' | 'updatedAt'
 >
 
 export type RequiredDataFromCollectionSlug<TSlug extends CollectionSlug> =
@@ -543,7 +543,17 @@ export type CollectionConfig<TSlug extends CollectionSlug = any> = {
   orderable?: boolean
   slug: string
   /**
-   * Add `createdAt` and `updatedAt` fields
+   * Enables soft delete support for this collection.
+   *
+   * When enabled, documents will include a `deletedAt` timestamp field.
+   * This allows documents to be marked as deleted without being permanently removed.
+   * The `deletedAt` field will be set to the current date and time when a document is deleted.
+   *
+   * @default false
+   */
+  softDeletes?: boolean
+  /**
+   * Add `createdAt`, `deletedAt` and `updatedAt` fields
    *
    * @default true
    */
@@ -666,6 +676,7 @@ export type TypeWithID = {
 export type TypeWithTimestamps = {
   [key: string]: unknown
   createdAt: string
+  deletedAt?: string
   id: number | string
   updatedAt: string
 }

diff --git a/packages/payload/src/collections/endpoints/delete.ts b/packages/payload/src/collections/endpoints/delete.ts
@@ -13,11 +13,12 @@ import { deleteOperation } from '../operations/delete.js'
 
 export const deleteHandler: PayloadHandler = async (req) => {
   const collection = getRequestCollection(req)
-  const { depth, overrideLock, populate, select, where } = req.query as {
+  const { depth, overrideLock, populate, select, trash, where } = req.query as {
     depth?: string
     overrideLock?: string
     populate?: Record<string, unknown>
     select?: Record<string, unknown>
+    trash?: string
     where?: Where
   }
 
@@ -28,6 +29,7 @@ export const deleteHandler: PayloadHandler = async (req) => {
     populate: sanitizePopulateParam(populate),
     req,
     select: sanitizeSelectParam(select),
+    trash: trash === 'true',
     where: where!,
   })
 

diff --git a/packages/payload/src/collections/endpoints/deleteByID.ts b/packages/payload/src/collections/endpoints/deleteByID.ts
@@ -14,6 +14,7 @@ export const deleteByIDHandler: PayloadHandler = async (req) => {
   const { searchParams } = req
   const depth = searchParams.get('depth')
   const overrideLock = searchParams.get('overrideLock')
+  const trash = searchParams.get('trash') === 'true'
 
   const doc = await deleteByIDOperation({
     id,
@@ -23,6 +24,7 @@ export const deleteByIDHandler: PayloadHandler = async (req) => {
     populate: sanitizePopulateParam(req.query.populate),
     req,
     select: sanitizeSelectParam(req.query.select),
+    trash,
   })
 
   const headers = headersWithCors({

diff --git a/packages/payload/src/collections/endpoints/find.ts b/packages/payload/src/collections/endpoints/find.ts
@@ -14,7 +14,7 @@ import { findOperation } from '../operations/find.js'
 
 export const findHandler: PayloadHandler = async (req) => {
   const collection = getRequestCollection(req)
-  const { depth, draft, joins, limit, page, pagination, populate, select, sort, where } =
+  const { depth, draft, joins, limit, page, pagination, populate, select, sort, trash, where } =
     req.query as {
       depth?: string
       draft?: string
@@ -25,6 +25,7 @@ export const findHandler: PayloadHandler = async (req) => {
       populate?: Record<string, unknown>
       select?: Record<string, unknown>
       sort?: string
+      trash?: string
       where?: Where
     }
 
@@ -40,6 +41,7 @@ export const findHandler: PayloadHandler = async (req) => {
     req,
     select: sanitizeSelectParam(select),
     sort: typeof sort === 'string' ? sort.split(',') : undefined,
+    trash: trash === 'true',
     where,
   })
 

diff --git a/packages/payload/src/collections/endpoints/findByID.ts b/packages/payload/src/collections/endpoints/findByID.ts
@@ -14,6 +14,7 @@ export const findByIDHandler: PayloadHandler = async (req) => {
   const { searchParams } = req
   const { id, collection } = getRequestCollectionWithID(req)
   const depth = searchParams.get('depth')
+  const trash = searchParams.get('trash') === 'true'
 
   const result = await findByIDOperation({
     id,
@@ -24,6 +25,7 @@ export const findByIDHandler: PayloadHandler = async (req) => {
     populate: sanitizePopulateParam(req.query.populate),
     req,
     select: sanitizeSelectParam(req.query.select),
+    trash,
   })
 
   return Response.json(result, {

diff --git a/packages/payload/src/collections/endpoints/findVersionByID.ts b/packages/payload/src/collections/endpoints/findVersionByID.ts
@@ -12,6 +12,7 @@ import { findVersionByIDOperation } from '../operations/findVersionByID.js'
 export const findVersionByIDHandler: PayloadHandler = async (req) => {
   const { searchParams } = req
   const depth = searchParams.get('depth')
+  const trash = searchParams.get('trash') === 'true'
 
   const { id, collection } = getRequestCollectionWithID(req)
 
@@ -22,6 +23,7 @@ export const findVersionByIDHandler: PayloadHandler = async (req) => {
     populate: sanitizePopulateParam(req.query.populate),
     req,
     select: sanitizeSelectParam(req.query.select),
+    trash,
   })
 
   return Response.json(result, {

diff --git a/packages/payload/src/collections/endpoints/findVersions.ts b/packages/payload/src/collections/endpoints/findVersions.ts
@@ -12,14 +12,15 @@ import { findVersionsOperation } from '../operations/findVersions.js'
 
 export const findVersionsHandler: PayloadHandler = async (req) => {
   const collection = getRequestCollection(req)
-  const { depth, limit, page, pagination, populate, select, sort, where } = req.query as {
+  const { depth, limit, page, pagination, populate, select, sort, trash, where } = req.query as {
     depth?: string
     limit?: string
     page?: string
     pagination?: string
     populate?: Record<string, unknown>
     select?: Record<string, unknown>
     sort?: string
+    trash?: string
     where?: Where
   }
 
@@ -33,6 +34,7 @@ export const findVersionsHandler: PayloadHandler = async (req) => {
     req,
     select: sanitizeSelectParam(select),
     sort: typeof sort === 'string' ? sort.split(',') : undefined,
+    trash: trash === 'true',
     where,
   })
 

diff --git a/packages/payload/src/collections/endpoints/update.ts b/packages/payload/src/collections/endpoints/update.ts
@@ -13,14 +13,15 @@ import { updateOperation } from '../operations/update.js'
 
 export const updateHandler: PayloadHandler = async (req) => {
   const collection = getRequestCollection(req)
-  const { depth, draft, limit, overrideLock, populate, select, sort, where } = req.query as {
+  const { depth, draft, limit, overrideLock, populate, select, sort, trash, where } = req.query as {
     depth?: string
     draft?: string
     limit?: string
     overrideLock?: string
     populate?: Record<string, unknown>
     select?: Record<string, unknown>
     sort?: string
+    trash?: string
     where?: Where
   }
 
@@ -35,6 +36,7 @@ export const updateHandler: PayloadHandler = async (req) => {
     req,
     select: sanitizeSelectParam(select),
     sort: typeof sort === 'string' ? sort.split(',') : undefined,
+    trash: trash === 'true',
     where: where!,
   })
 

diff --git a/packages/payload/src/collections/endpoints/updateByID.ts b/packages/payload/src/collections/endpoints/updateByID.ts
@@ -16,6 +16,7 @@ export const updateByIDHandler: PayloadHandler = async (req) => {
   const autosave = searchParams.get('autosave') === 'true'
   const draft = searchParams.get('draft') === 'true'
   const overrideLock = searchParams.get('overrideLock')
+  const trash = searchParams.get('trash') === 'true'
   const publishSpecificLocale = req.query.publishSpecificLocale as string | undefined
 
   const doc = await updateByIDOperation({
@@ -30,6 +31,7 @@ export const updateByIDHandler: PayloadHandler = async (req) => {
     publishSpecificLocale,
     req,
     select: sanitizeSelectParam(req.query.select),
+    trash,
   })
 
   let message = req.t('general:updatedSuccessfully')