@roxxel/payload-multilang 0.0.5 → 0.0.6

package/dist/translations.d.ts

@@ -0,0 +1,72 @@
+export declare const payloadMultilangTranslations: {
+    readonly en: {
+        readonly payloadMultilang: {
+            readonly allLanguages: "All languages";
+            readonly chooseLanguage: "Choose language";
+            readonly chooseTargetLanguage: "Choose a target language.";
+            readonly connectExisting: "Connect existing";
+            readonly createOrConnectDocuments: "Create or connect separate localized documents.";
+            readonly createTranslation: "Create translation";
+            readonly createTranslationFor: "Create {{language}} translation";
+            readonly current: "Current";
+            readonly disconnectDocument: "Disconnect this document";
+            readonly documentID: "Document ID";
+            readonly editTranslationFor: "Edit {{language}} translation";
+            readonly existingDocumentID: "Existing document ID";
+            readonly language: "Language";
+            readonly linkedDocuments: "Linked documents";
+            readonly localized: "Localized";
+            readonly localizedContent: "Localized content";
+            readonly missing: "Missing";
+            readonly saveBeforeAddingTranslations: "Save before adding translations.";
+            readonly saveBeforeCreatingTranslations: "Save the document before creating translations.";
+            readonly saveBeforeManagingTranslations: "Save the document before managing translations.";
+            readonly targetIDAndLanguageRequired: "Target ID and language are required.";
+            readonly translationActions: "Translation actions";
+            readonly translationConnected: "Translation connected.";
+            readonly translationCouldNotBeConnected: "Translation could not be connected.";
+            readonly translationCouldNotBeCreated: "Translation could not be created.";
+            readonly translationCouldNotBeDisconnected: "Translation could not be disconnected.";
+            readonly translationDisconnected: "Translation disconnected.";
+            readonly translations: "Translations";
+            readonly unassigned: "Unassigned";
+            readonly unassignedStoredLanguageNotConfigured: "Unassigned; stored language \"{{language}}\" is not configured";
+        };
+    };
+    readonly uk: {
+        readonly payloadMultilang: {
+            readonly allLanguages: "Усі мови";
+            readonly chooseLanguage: "Оберіть мову";
+            readonly chooseTargetLanguage: "Оберіть цільову мову.";
+            readonly connectExisting: "Підключити наявний";
+            readonly createOrConnectDocuments: "Створюйте або підключайте окремі локалізовані документи.";
+            readonly createTranslation: "Створити переклад";
+            readonly createTranslationFor: "Створити переклад: {{language}}";
+            readonly current: "Поточний";
+            readonly disconnectDocument: "Від’єднати цей документ";
+            readonly documentID: "ID документа";
+            readonly editTranslationFor: "Редагувати переклад: {{language}}";
+            readonly existingDocumentID: "ID наявного документа";
+            readonly language: "Мова";
+            readonly linkedDocuments: "Пов’язані документи";
+            readonly localized: "Локалізовано";
+            readonly localizedContent: "Локалізований вміст";
+            readonly missing: "Відсутній";
+            readonly saveBeforeAddingTranslations: "Збережіть перед додаванням перекладів.";
+            readonly saveBeforeCreatingTranslations: "Збережіть документ перед створенням перекладів.";
+            readonly saveBeforeManagingTranslations: "Збережіть документ перед керуванням перекладами.";
+            readonly targetIDAndLanguageRequired: "Потрібні ID цільового документа та мова.";
+            readonly translationActions: "Дії з перекладами";
+            readonly translationConnected: "Переклад підключено.";
+            readonly translationCouldNotBeConnected: "Не вдалося підключити переклад.";
+            readonly translationCouldNotBeCreated: "Не вдалося створити переклад.";
+            readonly translationCouldNotBeDisconnected: "Не вдалося від’єднати переклад.";
+            readonly translationDisconnected: "Переклад від’єднано.";
+            readonly translations: "Переклади";
+            readonly unassigned: "Не призначено";
+            readonly unassignedStoredLanguageNotConfigured: "Не призначено; збережена мова \"{{language}}\" не налаштована";
+        };
+    };
+};
+export type PayloadMultilangTranslations = (typeof payloadMultilangTranslations)['en'];
+export type PayloadMultilangTranslationKey = `payloadMultilang:${keyof PayloadMultilangTranslations['payloadMultilang']}`;

package/dist/translations.js

@@ -0,0 +1,72 @@
+export const payloadMultilangTranslations = {
+    en: {
+        payloadMultilang: {
+            allLanguages: 'All languages',
+            chooseLanguage: 'Choose language',
+            chooseTargetLanguage: 'Choose a target language.',
+            connectExisting: 'Connect existing',
+            createOrConnectDocuments: 'Create or connect separate localized documents.',
+            createTranslation: 'Create translation',
+            createTranslationFor: 'Create {{language}} translation',
+            current: 'Current',
+            disconnectDocument: 'Disconnect this document',
+            documentID: 'Document ID',
+            editTranslationFor: 'Edit {{language}} translation',
+            existingDocumentID: 'Existing document ID',
+            language: 'Language',
+            linkedDocuments: 'Linked documents',
+            localized: 'Localized',
+            localizedContent: 'Localized content',
+            missing: 'Missing',
+            saveBeforeAddingTranslations: 'Save before adding translations.',
+            saveBeforeCreatingTranslations: 'Save the document before creating translations.',
+            saveBeforeManagingTranslations: 'Save the document before managing translations.',
+            targetIDAndLanguageRequired: 'Target ID and language are required.',
+            translationActions: 'Translation actions',
+            translationConnected: 'Translation connected.',
+            translationCouldNotBeConnected: 'Translation could not be connected.',
+            translationCouldNotBeCreated: 'Translation could not be created.',
+            translationCouldNotBeDisconnected: 'Translation could not be disconnected.',
+            translationDisconnected: 'Translation disconnected.',
+            translations: 'Translations',
+            unassigned: 'Unassigned',
+            unassignedStoredLanguageNotConfigured: 'Unassigned; stored language "{{language}}" is not configured'
+        }
+    },
+    uk: {
+        payloadMultilang: {
+            allLanguages: 'Усі мови',
+            chooseLanguage: 'Оберіть мову',
+            chooseTargetLanguage: 'Оберіть цільову мову.',
+            connectExisting: 'Підключити наявний',
+            createOrConnectDocuments: 'Створюйте або підключайте окремі локалізовані документи.',
+            createTranslation: 'Створити переклад',
+            createTranslationFor: 'Створити переклад: {{language}}',
+            current: 'Поточний',
+            disconnectDocument: 'Від’єднати цей документ',
+            documentID: 'ID документа',
+            editTranslationFor: 'Редагувати переклад: {{language}}',
+            existingDocumentID: 'ID наявного документа',
+            language: 'Мова',
+            linkedDocuments: 'Пов’язані документи',
+            localized: 'Локалізовано',
+            localizedContent: 'Локалізований вміст',
+            missing: 'Відсутній',
+            saveBeforeAddingTranslations: 'Збережіть перед додаванням перекладів.',
+            saveBeforeCreatingTranslations: 'Збережіть документ перед створенням перекладів.',
+            saveBeforeManagingTranslations: 'Збережіть документ перед керуванням перекладами.',
+            targetIDAndLanguageRequired: 'Потрібні ID цільового документа та мова.',
+            translationActions: 'Дії з перекладами',
+            translationConnected: 'Переклад підключено.',
+            translationCouldNotBeConnected: 'Не вдалося підключити переклад.',
+            translationCouldNotBeCreated: 'Не вдалося створити переклад.',
+            translationCouldNotBeDisconnected: 'Не вдалося від’єднати переклад.',
+            translationDisconnected: 'Переклад від’єднано.',
+            translations: 'Переклади',
+            unassigned: 'Не призначено',
+            unassignedStoredLanguageNotConfigured: 'Не призначено; збережена мова "{{language}}" не налаштована'
+        }
+    }
+};
+
+//# sourceMappingURL=translations.js.map

package/dist/translations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/translations.ts"],"sourcesContent":["export const payloadMultilangTranslations = {\n  en: {\n    payloadMultilang: {\n      allLanguages: 'All languages',\n      chooseLanguage: 'Choose language',\n      chooseTargetLanguage: 'Choose a target language.',\n      connectExisting: 'Connect existing',\n      createOrConnectDocuments: 'Create or connect separate localized documents.',\n      createTranslation: 'Create translation',\n      createTranslationFor: 'Create {{language}} translation',\n      current: 'Current',\n      disconnectDocument: 'Disconnect this document',\n      documentID: 'Document ID',\n      editTranslationFor: 'Edit {{language}} translation',\n      existingDocumentID: 'Existing document ID',\n      language: 'Language',\n      linkedDocuments: 'Linked documents',\n      localized: 'Localized',\n      localizedContent: 'Localized content',\n      missing: 'Missing',\n      saveBeforeAddingTranslations: 'Save before adding translations.',\n      saveBeforeCreatingTranslations: 'Save the document before creating translations.',\n      saveBeforeManagingTranslations: 'Save the document before managing translations.',\n      targetIDAndLanguageRequired: 'Target ID and language are required.',\n      translationActions: 'Translation actions',\n      translationConnected: 'Translation connected.',\n      translationCouldNotBeConnected: 'Translation could not be connected.',\n      translationCouldNotBeCreated: 'Translation could not be created.',\n      translationCouldNotBeDisconnected: 'Translation could not be disconnected.',\n      translationDisconnected: 'Translation disconnected.',\n      translations: 'Translations',\n      unassigned: 'Unassigned',\n      unassignedStoredLanguageNotConfigured:\n        'Unassigned; stored language \"{{language}}\" is not configured',\n    },\n  },\n  uk: {\n    payloadMultilang: {\n      allLanguages: 'Усі мови',\n      chooseLanguage: 'Оберіть мову',\n      chooseTargetLanguage: 'Оберіть цільову мову.',\n      connectExisting: 'Підключити наявний',\n      createOrConnectDocuments: 'Створюйте або підключайте окремі локалізовані документи.',\n      createTranslation: 'Створити переклад',\n      createTranslationFor: 'Створити переклад: {{language}}',\n      current: 'Поточний',\n      disconnectDocument: 'Від’єднати цей документ',\n      documentID: 'ID документа',\n      editTranslationFor: 'Редагувати переклад: {{language}}',\n      existingDocumentID: 'ID наявного документа',\n      language: 'Мова',\n      linkedDocuments: 'Пов’язані документи',\n      localized: 'Локалізовано',\n      localizedContent: 'Локалізований вміст',\n      missing: 'Відсутній',\n      saveBeforeAddingTranslations: 'Збережіть перед додаванням перекладів.',\n      saveBeforeCreatingTranslations: 'Збережіть документ перед створенням перекладів.',\n      saveBeforeManagingTranslations: 'Збережіть документ перед керуванням перекладами.',\n      targetIDAndLanguageRequired: 'Потрібні ID цільового документа та мова.',\n      translationActions: 'Дії з перекладами',\n      translationConnected: 'Переклад підключено.',\n      translationCouldNotBeConnected: 'Не вдалося підключити переклад.',\n      translationCouldNotBeCreated: 'Не вдалося створити переклад.',\n      translationCouldNotBeDisconnected: 'Не вдалося від’єднати переклад.',\n      translationDisconnected: 'Переклад від’єднано.',\n      translations: 'Переклади',\n      unassigned: 'Не призначено',\n      unassignedStoredLanguageNotConfigured:\n        'Не призначено; збережена мова \"{{language}}\" не налаштована',\n    },\n  },\n} as const\n\nexport type PayloadMultilangTranslations =\n  (typeof payloadMultilangTranslations)['en']\n\nexport type PayloadMultilangTranslationKey =\n  `payloadMultilang:${keyof PayloadMultilangTranslations['payloadMultilang']}`\n"],"names":["payloadMultilangTranslations","en","payloadMultilang","allLanguages","chooseLanguage","chooseTargetLanguage","connectExisting","createOrConnectDocuments","createTranslation","createTranslationFor","current","disconnectDocument","documentID","editTranslationFor","existingDocumentID","language","linkedDocuments","localized","localizedContent","missing","saveBeforeAddingTranslations","saveBeforeCreatingTranslations","saveBeforeManagingTranslations","targetIDAndLanguageRequired","translationActions","translationConnected","translationCouldNotBeConnected","translationCouldNotBeCreated","translationCouldNotBeDisconnected","translationDisconnected","translations","unassigned","unassignedStoredLanguageNotConfigured","uk"],"mappings":"AAAA,OAAO,MAAMA,+BAA+B;IAC1CC,IAAI;QACFC,kBAAkB;YAChBC,cAAc;YACdC,gBAAgB;YAChBC,sBAAsB;YACtBC,iBAAiB;YACjBC,0BAA0B;YAC1BC,mBAAmB;YACnBC,sBAAsB;YACtBC,SAAS;YACTC,oBAAoB;YACpBC,YAAY;YACZC,oBAAoB;YACpBC,oBAAoB;YACpBC,UAAU;YACVC,iBAAiB;YACjBC,WAAW;YACXC,kBAAkB;YAClBC,SAAS;YACTC,8BAA8B;YAC9BC,gCAAgC;YAChCC,gCAAgC;YAChCC,6BAA6B;YAC7BC,oBAAoB;YACpBC,sBAAsB;YACtBC,gCAAgC;YAChCC,8BAA8B;YAC9BC,mCAAmC;YACnCC,yBAAyB;YACzBC,cAAc;YACdC,YAAY;YACZC,uCACE;QACJ;IACF;IACAC,IAAI;QACF/B,kBAAkB;YAChBC,cAAc;YACdC,gBAAgB;YAChBC,sBAAsB;YACtBC,iBAAiB;YACjBC,0BAA0B;YAC1BC,mBAAmB;YACnBC,sBAAsB;YACtBC,SAAS;YACTC,oBAAoB;YACpBC,YAAY;YACZC,oBAAoB;YACpBC,oBAAoB;YACpBC,UAAU;YACVC,iBAAiB;YACjBC,WAAW;YACXC,kBAAkB;YAClBC,SAAS;YACTC,8BAA8B;YAC9BC,gCAAgC;YAChCC,gCAAgC;YAChCC,6BAA6B;YAC7BC,oBAAoB;YACpBC,sBAAsB;YACtBC,gCAAgC;YAChCC,8BAA8B;YAC9BC,mCAAmC;YACnCC,yBAAyB;YACzBC,cAAc;YACdC,YAAY;YACZC,uCACE;QACJ;IACF;AACF,EAAU"}

package/dist/types.d.ts

@@ -17,22 +17,10 @@ export type MultilangLanguage = {
     order?: number;
 };
 export type MultilangCollectionOptions = {
-    /**
-     * Set to false to create empty translation documents by default.
-     */
-    duplicate?: boolean;
-    /**
-     * Additional top-level document field names that should not be copied when creating a translation.
-     */
-    duplicateExcludeFields?: string[];
     /**
      * Override hidden metadata field names for this collection.
      */
     fields?: Partial<MultilangFieldNames>;
-    /**
-     * Top-level document field names that should share one value across every language in a translation group.
-     */
-    synchronizedFields?: string[];
 };
 export type MultilangGlobalOptions = {
     /**
@@ -49,10 +37,6 @@ export type PayloadMultilangConfig = {
      * Disable runtime UI/endpoints/hooks while keeping schema fields in place.
      */
     disabled?: boolean;
-    /**
-     * Global duplicate exclusions applied to all enabled collections.
-     */
-    duplicateExcludeFields?: string[];
     /**
      * Global hidden metadata field name overrides.
      */
@@ -69,12 +53,9 @@ export type PayloadMultilangConfig = {
 };
 export type ResolvedMultilangCollection = {
     defaultLanguage: MultilangLanguage;
-    duplicate: boolean;
-    duplicateExcludeFields: string[];
     fieldNames: MultilangFieldNames;
     languages: MultilangLanguage[];
     slug: string;
-    synchronizedFields: string[];
 };
 export type ResolvedMultilangGlobal = {
     defaultLanguage: MultilangLanguage;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { CollectionSlug, GlobalSlug, Where } from 'payload'\n\nexport type MultilangDirection = 'ltr' | 'rtl'\n\nexport type MultilangFieldNames = {\n  group: string\n  language: string\n  meta: string\n}\n\nexport type MultilangLanguage = {\n  active?: boolean\n  code: string\n  direction?: MultilangDirection\n  flagLabel?: string\n  id?: number | string\n  isDefault?: boolean\n  locale?: string\n  name: string\n  order?: number\n}\n\nexport type MultilangCollectionOptions = {\n  /**\n   * Set to false to create empty translation documents by default.\n   */\n  duplicate?: boolean\n  /**\n   * Additional top-level document field names that should not be copied when creating a translation.\n   */\n  duplicateExcludeFields?: string[]\n  /**\n   * Override hidden metadata field names for this collection.\n   */\n  fields?: Partial<MultilangFieldNames>\n  /**\n   * Top-level document field names that should share one value across every language in a translation group.\n   */\n  synchronizedFields?: string[]\n}\n\nexport type MultilangGlobalOptions = {\n  /**\n   * Override the top-level tabs field label used to group localized global fields.\n   */\n  label?: string\n}\n\nexport type PayloadMultilangConfig = {\n  /**\n   * Payload collections that should use Polylang-style document translations.\n   */\n  collections?: Partial<Record<CollectionSlug, MultilangCollectionOptions | true>>\n  /**\n   * Disable runtime UI/endpoints/hooks while keeping schema fields in place.\n   */\n  disabled?: boolean\n  /**\n   * Global duplicate exclusions applied to all enabled collections.\n   */\n  duplicateExcludeFields?: string[]\n  /**\n   * Global hidden metadata field name overrides.\n   */\n  fieldNames?: Partial<MultilangFieldNames>\n  /**\n   * Payload globals that should store language-specific values in one singleton document.\n   */\n  globals?: Partial<Record<GlobalSlug, MultilangGlobalOptions | true>>\n  /**\n   * Languages available to translated collections. Codes are normalized to\n   * lowercase during plugin setup.\n   */\n  languages: MultilangLanguage[]\n}\n\nexport type ResolvedMultilangCollection = {\n  defaultLanguage: MultilangLanguage\n  duplicate: boolean\n  duplicateExcludeFields: string[]\n  fieldNames: MultilangFieldNames\n  languages: MultilangLanguage[]\n  slug: string\n  synchronizedFields: string[]\n}\n\nexport type ResolvedMultilangGlobal = {\n  defaultLanguage: MultilangLanguage\n  label: string\n  languages: MultilangLanguage[]\n  slug: string\n}\n\nexport type TranslationMap<TDoc = Record<string, unknown>> = Record<string, TDoc>\n\nexport type TranslationState<TDoc = Record<string, unknown>> = {\n  group?: string\n  language?: string\n  source?: TDoc\n  translations: TranslationMap<TDoc>\n}\n\nexport type WithLanguageArgs = {\n  fieldName?: string\n  language: string\n  where?: Where\n}\n"],"names":[],"mappings":"AAsGA,WAIC"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { CollectionSlug, GlobalSlug, Where } from 'payload'\n\nexport type MultilangDirection = 'ltr' | 'rtl'\n\nexport type MultilangFieldNames = {\n  group: string\n  language: string\n  meta: string\n}\n\nexport type MultilangLanguage = {\n  active?: boolean\n  code: string\n  direction?: MultilangDirection\n  flagLabel?: string\n  id?: number | string\n  isDefault?: boolean\n  locale?: string\n  name: string\n  order?: number\n}\n\nexport type MultilangCollectionOptions = {\n  /**\n   * Override hidden metadata field names for this collection.\n   */\n  fields?: Partial<MultilangFieldNames>\n}\n\nexport type MultilangGlobalOptions = {\n  /**\n   * Override the top-level tabs field label used to group localized global fields.\n   */\n  label?: string\n}\n\nexport type PayloadMultilangConfig = {\n  /**\n   * Payload collections that should use Polylang-style document translations.\n   */\n  collections?: Partial<Record<CollectionSlug, MultilangCollectionOptions | true>>\n  /**\n   * Disable runtime UI/endpoints/hooks while keeping schema fields in place.\n   */\n  disabled?: boolean\n  /**\n   * Global hidden metadata field name overrides.\n   */\n  fieldNames?: Partial<MultilangFieldNames>\n  /**\n   * Payload globals that should store language-specific values in one singleton document.\n   */\n  globals?: Partial<Record<GlobalSlug, MultilangGlobalOptions | true>>\n  /**\n   * Languages available to translated collections. Codes are normalized to\n   * lowercase during plugin setup.\n   */\n  languages: MultilangLanguage[]\n}\n\nexport type ResolvedMultilangCollection = {\n  defaultLanguage: MultilangLanguage\n  fieldNames: MultilangFieldNames\n  languages: MultilangLanguage[]\n  slug: string\n}\n\nexport type ResolvedMultilangGlobal = {\n  defaultLanguage: MultilangLanguage\n  label: string\n  languages: MultilangLanguage[]\n  slug: string\n}\n\nexport type TranslationMap<TDoc = Record<string, unknown>> = Record<string, TDoc>\n\nexport type TranslationState<TDoc = Record<string, unknown>> = {\n  group?: string\n  language?: string\n  source?: TDoc\n  translations: TranslationMap<TDoc>\n}\n\nexport type WithLanguageArgs = {\n  fieldName?: string\n  language: string\n  where?: Where\n}\n"],"names":[],"mappings":"AAmFA,WAIC"}

package/docs/configuration.md

@@ -42,7 +42,6 @@ Payload built-in localization must stay disabled. This plugin models translation
 | `collections`            | `Record<string, true \| MultilangCollectionOptions>` | Collection slugs to localize.                                                                                          |
 | `globals`                | `Record<string, true \| MultilangGlobalOptions>`     | Global slugs to localize.                                                                                              |
 | `fieldNames`             | `Partial<MultilangFieldNames>`                       | Optional custom field names used by localized collections.                                                             |
-| `duplicateExcludeFields` | `string[]`                                           | Extra top-level fields to skip when a new translation duplicates source document data.                                 |
 | `disabled`               | `boolean`                                            | Returns the Payload config unchanged when true. Useful for temporary opt-out in specific environments.                 |
 
 ## Content Model
@@ -59,6 +58,31 @@ Translated collection entries are independent Payload documents. The plugin adds
 
 Do not mark content fields as `localized: true` for this plugin model. Put translated text directly on each language document instead.
 
+## Admin UI Translations
+
+The plugin registers its own admin UI translations for English (`en`) and Ukrainian (`uk`) through Payload `i18n.translations`.
+
+Apps can override any plugin string by setting the same translation keys after installing the plugin:
+
+```ts
+export default buildConfig({
+  i18n: {
+    translations: {
+      uk: {
+        payloadMultilang: {
+          translations: 'Переклади',
+        },
+      },
+    },
+  },
+  plugins: [
+    payloadMultilang({
+      languages,
+    }),
+  ],
+})
+```
+
 ## Languages
 
 ```ts
@@ -117,11 +141,7 @@ Use collection options when you need custom translation behavior.
 ```ts
 payloadMultilang({
   collections: {
-    posts: {
-      duplicate: true,
-      duplicateExcludeFields: ['legacyId'],
-      synchronizedFields: ['featuredImage', 'author'],
-    },
+    posts: true,
   },
   languages,
 })
@@ -129,10 +149,24 @@ payloadMultilang({
 
 | Option                   | Type                           | Description                                                                                                                                                          |
 | ------------------------ | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `duplicate`              | `boolean`                      | Defaults to `true`. When creating a translation, copy source document fields into the new document. Set to `false` to create empty translation documents by default. |
-| `duplicateExcludeFields` | `string[]`                     | Additional top-level fields to skip during duplication for this collection.                                                                                          |
 | `fields`                 | `Partial<MultilangFieldNames>` | Override metadata field names for this collection.                                                                                                                   |
-| `synchronizedFields`     | `string[]`                     | Top-level fields that should stay the same across all translations in a group.                                                                                       |
+
+Mark fields that should stay shared across translations directly in the field config:
+
+```ts
+{
+  name: 'featuredImage',
+  type: 'upload',
+  relationTo: 'media',
+  custom: {
+    multilang: {
+      synchronize: true,
+    },
+  },
+}
+```
+
+For repeatable fields with child fields, such as `array` and `blocks`, synchronization only applies to the outer shell. Item IDs, order, block types, and block names follow the source document, while each translation keeps its own nested field values.
 
 ## Globals
 

package/docs/usage.md

@@ -236,48 +236,24 @@ await multilang.updateGlobalByLanguage({
 
 ## Keep Shared Fields in Sync
 
-Use `synchronizedFields` for top-level fields that should be identical across translations, such as author, featured image, or canonical taxonomy.
+Set `custom.multilang.synchronize` on top-level fields that should be identical across translations, such as author, featured image, or canonical taxonomy.
 
 ```ts
-payloadMultilang({
-  collections: {
-    posts: {
-      synchronizedFields: ['featuredImage', 'author', 'category'],
+{
+  name: 'featuredImage',
+  type: 'upload',
+  relationTo: 'media',
+  custom: {
+    multilang: {
+      synchronize: true,
     },
   },
-  languages,
-})
+}
 ```
 
 When an editor changes one of those fields on a saved translation, the plugin updates the same field on the other linked translations.
 
-## Create Empty Translations
-
-By default, creating a translation duplicates compatible top-level source fields. To make new translations start empty:
-
-```ts
-payloadMultilang({
-  collections: {
-    posts: {
-      duplicate: false,
-    },
-  },
-  languages,
-})
-```
-
-To duplicate most fields but exclude specific ones:
-
-```ts
-payloadMultilang({
-  collections: {
-    posts: {
-      duplicateExcludeFields: ['slug', 'seoTitle', 'seoDescription'],
-    },
-  },
-  languages,
-})
-```
+For `array` and `blocks` fields, synchronization keeps the outer shell aligned only. The row IDs, order, block types, and block names sync across translations, but nested field values inside each row or block stay language-specific.
 
 ## Generate Types
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roxxel/payload-multilang",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Polylang-style document localization for Payload CMS",
   "license": "MIT",
   "repository": {