feat(ui): experimental localize metadata UI

docs/configuration/localization.mdx

@@ -167,6 +167,39 @@ All field types with a `name` property support the `localized` property—even t
   strategy.
 </Banner>
 
+## Status Localization
+
+Payload allows you to localize the `status` field for **draft enabled** collections and globals. This lets you manage publication status independently for each locale, ensures the admin UI always shows the status for the selected locale, and unpublish content in a single locale.
+
+To enable this feature, set `versions.drafts.localizeStatus` to `true` in your collection or global config:
+
+```ts
+import type { CollectionConfig } from 'payload'
+
+export const Posts: CollectionConfig = {
+  // ...
+  versions: {
+    drafts: {
+      // highlight-start
+      localizeStatus: true,
+      // highlight-end
+    },
+  },
+}
+```
+
+When enabled, the `status` field will be stored as an object keyed by locales:
+
+```ts
+status: {
+  en: 'published',
+  es: 'draft',
+  de: 'published',
+}
+```
+
+`localizeStatus` is disabled by default, in which case the `status` field returns a single string (`'draft'` or `'published'`) representing the latest document status across all locales.
+
 ## Retrieving Localized Docs
 
 When retrieving documents, you can specify which locale you'd like to receive as well as which fallback locale should be

docs/versions/drafts.mdx

@@ -24,6 +24,7 @@ Collections and Globals both support the same options for configuring drafts. Yo
 | Draft Option      | Description                                                                                                                                                      |
 | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `autosave`        | Enable `autosave` to automatically save progress while documents are edited. To enable, set to `true` or pass an object with [options](/docs/versions/autosave). |
+| `localizeStatus`  | Localizes the `_status` field when using [Localization](/docs/configuration/localization). Default is `false`.                                                   |
 | `schedulePublish` | Allow for editors to schedule publish / unpublish events in the future. [More](#scheduled-publish)                                                               |
 | `validate`        | Set `validate` to `true` to validate draft documents when saved. Default is `false`.                                                                             |
 

packages/next/src/elements/DocumentHeader/Tabs/tabs/VersionsPill/index.scss

@@ -5,5 +5,6 @@
     text-align: center;
     background-color: var(--theme-elevation-100);
     border-radius: var(--style-radius-s);
+    padding: 2px 4px;
   }
 }

packages/next/src/views/Document/getVersions.ts

@@ -1,4 +1,4 @@
-import { sanitizeID } from '@payloadcms/ui/shared'
+import { sanitizeID, traverseForLocalizedFields } from '@payloadcms/ui/shared'
 import {
   combineQueries,
   extractAccessFromPermission,
@@ -56,6 +56,11 @@ export const getVersions = async ({
 
   const entityConfig = collectionConfig || globalConfig
   const versionsConfig = entityConfig?.versions
+  const hasLocalizedFields = traverseForLocalizedFields(entityConfig.fields)
+  const localizedDraftsEnabled =
+    hasDraftsEnabled(entityConfig) &&
+    typeof payload.config.localization === 'object' &&
+    hasLocalizedFields
 
   const shouldFetchVersions = Boolean(versionsConfig && docPermissions?.readVersions)
 
@@ -128,26 +133,34 @@ export const getVersions = async ({
       }
 
       if (hasAutosaveEnabled(collectionConfig)) {
+        const where: Record<string, any> = {
+          and: [
+            {
+              parent: {
+                equals: id,
+              },
+            },
+          ],
+        }
+
+        if (localizedDraftsEnabled) {
+          where.and.push({
+            snapshot: {
+              not_equals: true,
+            },
+          })
+        }
+
         const mostRecentVersion = await payload.findVersions({
           collection: collectionConfig.slug,
           depth: 0,
           limit: 1,
+          locale,
           select: {
             autosave: true,
           },
           user,
-          where: combineQueries(
-            {
-              and: [
-                {
-                  parent: {
-                    equals: id,
-                  },
-                },
-              ],
-            },
-            extractAccessFromPermission(docPermissions.readVersions),
-          ),
+          where: combineQueries(where, extractAccessFromPermission(docPermissions.readVersions)),
         })
 
         if (
@@ -162,6 +175,7 @@ export const getVersions = async ({
       if (publishedDoc?.updatedAt) {
         ;({ totalDocs: unpublishedVersionCount } = await payload.countVersions({
           collection: collectionConfig.slug,
+          locale,
           user,
           where: combineQueries(
             {
@@ -189,20 +203,31 @@ export const getVersions = async ({
       }
     }
 
+    const countVersionsWhere: Record<string, any> = {
+      and: [
+        {
+          parent: {
+            equals: id,
+          },
+        },
+      ],
+    }
+
+    if (localizedDraftsEnabled) {
+      countVersionsWhere.and.push({
+        snapshot: {
+          not_equals: true,
+        },
+      })
+    }
+
     ;({ totalDocs: versionCount } = await payload.countVersions({
       collection: collectionConfig.slug,
       depth: 0,
+      locale,
       user,
       where: combineQueries(
-        {
-          and: [
-            {
-              parent: {
-                equals: id,
-              },
-            },
-          ],
-        },
+        countVersionsWhere,
         extractAccessFromPermission(docPermissions.readVersions),
       ),
     }))
@@ -233,6 +258,7 @@ export const getVersions = async ({
         const mostRecentVersion = await payload.findGlobalVersions({
           slug: globalConfig.slug,
           limit: 1,
+          locale,
           select: {
             autosave: true,
           },
@@ -252,6 +278,7 @@ export const getVersions = async ({
         ;({ totalDocs: unpublishedVersionCount } = await payload.countGlobalVersions({
           depth: 0,
           global: globalConfig.slug,
+          locale,
           user,
           where: combineQueries(
             {
@@ -277,7 +304,15 @@ export const getVersions = async ({
     ;({ totalDocs: versionCount } = await payload.countGlobalVersions({
       depth: 0,
       global: globalConfig.slug,
+      locale,
       user,
+      where: localizedDraftsEnabled
+        ? {
+            snapshot: {
+              not_equals: true,
+            },
+          }
+        : undefined,
     }))
   }
 

packages/next/src/views/Version/VersionPillLabel/VersionPillLabel.tsx

@@ -1,5 +1,7 @@
 'use client'
 
+import type { TypeWithVersion } from 'payload'
+
 import { Pill, useConfig, useTranslation } from '@payloadcms/ui'
 import { formatDate } from '@payloadcms/ui/shared'
 import React from 'react'
@@ -18,10 +20,7 @@ const renderPill = (label: React.ReactNode, pillStyle: Parameters<typeof Pill>[0
 }
 
 export const VersionPillLabel: React.FC<{
-  currentlyPublishedVersion?: {
-    id: number | string
-    updatedAt: string
-  }
+  currentlyPublishedVersion?: TypeWithVersion<any>
   disableDate?: boolean
 
   doc: {
@@ -31,7 +30,8 @@ export const VersionPillLabel: React.FC<{
     updatedAt?: string
     version: {
       [key: string]: unknown
-      _status: string
+      _status: 'draft' | 'published'
+      updatedAt: string
     }
   }
   /**
@@ -45,10 +45,7 @@ export const VersionPillLabel: React.FC<{
    */
   labelStyle?: 'pill' | 'text'
   labelSuffix?: React.ReactNode
-  latestDraftVersion?: {
-    id: number | string
-    updatedAt: string
-  }
+  latestDraftVersion?: TypeWithVersion<any>
 }> = ({
   currentlyPublishedVersion,
   disableDate = false,

packages/next/src/views/Version/VersionPillLabel/getVersionLabel.ts

@@ -1,10 +1,15 @@
 import type { TFunction } from '@payloadcms/translations'
-import type { Pill } from '@payloadcms/ui'
+
+import { type Pill, useLocale } from '@payloadcms/ui'
 
 type Args = {
   currentlyPublishedVersion?: {
     id: number | string
+    publishedLocale?: string
     updatedAt: string
+    version: {
+      updatedAt: string
+    }
   }
   latestDraftVersion?: {
     id: number | string
@@ -13,7 +18,8 @@ type Args = {
   t: TFunction
   version: {
     id: number | string
-    version: { _status?: string }
+    publishedLocale?: string
+    version: { _status?: 'draft' | 'published'; updatedAt: string }
   }
 }
 
@@ -31,32 +37,49 @@ export function getVersionLabel({
   name: 'currentDraft' | 'currentlyPublished' | 'draft' | 'previouslyPublished' | 'published'
   pillStyle: Parameters<typeof Pill>[0]['pillStyle']
 } {
-  const publishedNewerThanDraft =
-    currentlyPublishedVersion?.updatedAt > latestDraftVersion?.updatedAt
+  const { code: currentLocale } = useLocale()
+  const status = version.version._status
+
+  if (status === 'draft') {
+    const publishedNewerThanDraft =
+      currentlyPublishedVersion?.updatedAt > latestDraftVersion?.updatedAt
 
-  if (version.version._status === 'draft') {
     if (publishedNewerThanDraft) {
       return {
         name: 'draft',
         label: t('version:draft'),
         pillStyle: 'light',
       }
-    } else {
-      return {
-        name: version.id === latestDraftVersion?.id ? 'currentDraft' : 'draft',
-        label:
-          version.id === latestDraftVersion?.id ? t('version:currentDraft') : t('version:draft'),
-        pillStyle: 'light',
-      }
     }
-  } else {
-    const isCurrentlyPublished = version.id === currentlyPublishedVersion?.id
+
+    const isCurrentDraft = version.id === latestDraftVersion?.id
+
+    return {
+      name: isCurrentDraft ? 'currentDraft' : 'draft',
+      label: isCurrentDraft ? t('version:currentDraft') : t('version:draft'),
+      pillStyle: 'light',
+    }
+  }
+
+  const publishedInAnotherLocale =
+    status === 'published' && version.publishedLocale && currentLocale !== version.publishedLocale
+
+  if (publishedInAnotherLocale) {
     return {
-      name: isCurrentlyPublished ? 'currentlyPublished' : 'previouslyPublished',
-      label: isCurrentlyPublished
-        ? t('version:currentlyPublished')
-        : t('version:previouslyPublished'),
-      pillStyle: isCurrentlyPublished ? 'success' : 'light',
+      name: 'currentDraft',
+      label: t('version:currentDraft'),
+      pillStyle: 'light',
     }
   }
+
+  const isCurrentlyPublished =
+    currentlyPublishedVersion && version.id === currentlyPublishedVersion.id
+
+  return {
+    name: isCurrentlyPublished ? 'currentlyPublished' : 'previouslyPublished',
+    label: isCurrentlyPublished
+      ? t('version:currentlyPublished')
+      : t('version:previouslyPublished'),
+    pillStyle: isCurrentlyPublished ? 'success' : 'light',
+  }
 }

packages/next/src/views/Version/index.tsx

@@ -121,7 +121,7 @@ export async function VersionView(props: DocumentViewServerProps) {
           collectionSlug,
           depth: 0,
           globalSlug,
-          locale: 'all',
+          locale: req.locale,
           overrideAccess: false,
           parentID: id,
           req,

packages/next/src/views/Versions/buildColumns.tsx

@@ -28,19 +28,13 @@ export const buildVersionColumns = ({
 }: {
   collectionConfig?: SanitizedCollectionConfig
   CreatedAtCellOverride?: React.ComponentType<CreatedAtCellProps>
-  currentlyPublishedVersion?: {
-    id: number | string
-    updatedAt: string
-  }
+  currentlyPublishedVersion?: TypeWithVersion<any>
   docID?: number | string
   docs: PaginatedDocs<TypeWithVersion<any>>['docs']
   globalConfig?: SanitizedGlobalConfig
   i18n: I18n
   isTrashed?: boolean
-  latestDraftVersion?: {
-    id: number | string
-    updatedAt: string
-  }
+  latestDraftVersion?: TypeWithVersion<any>
 }): Column[] => {
   const entityConfig = collectionConfig || globalConfig