Contentful純正「Locale Field Populator」でロケール間の一括コピーを試してみた
どうも！オペ部の西村祐二です！
Contentfulのブログを書きたいなと思い、最近のアップデート情報を眺めていたところ、良さそうなリリースを見つけました。
2026年2月にContentful公式からリリースされたLocale Field PopulatorというMarketplaceアプリです（Changelogで告知）。
Contentfulで多言語コンテンツを管理していると、「同じ内容を複数のロケールにコピーする作業」が地味に面倒ですよね。特にEN-USで書いた内容をEN-UK・EN-AUにも展開するような、ほぼ同じだけどロケールごとにフィールドを埋めないといけないケースは手作業だとかなり辛いものがあります。
Locale Field Populatorはそのあたりを楽にしてくれるアプリみたいです。
実際にインストールして試してみたので、気づいたことをまとめます。
試してみた
Locale Field PopulatorをContentfulのMarketplaceからインストールし、Contentful 101のチュートリアルで作成したコンテンツタイプを対象に、フィールド値の自動コピーを試しました。
環境:
- Contentful Web App
- ロケール構成: EN-US（ソース）、EN-UK（英語バリアント）
- スペースの管理者（Admin）権限が必要（Marketplaceアプリのインストールのため）
- スペースに2つ以上のロケールが設定済みであること（ロケールが1つだけだとコピー先がないため）
0. 事前準備：ロケールの追加
Locale Field Populatorはソースロケールの値をターゲットロケールにコピーするアプリなので、スペースに2つ以上のロケールが必要です。
エントリのサイドバーを見ると、Active locales にロケールが1つしか表示されていない場合は、先にロケールを追加しましょう。
ロケールの追加手順
- 上部ナビゲーションバーの Settings ドロップダウンを開く
- Environment settings の中にある Locales をクリック
- Locales画面が表示される。現在のロケール一覧を確認し、左下の + Add locale をクリック
- ロケール設定画面で以下を設定する
- Locale: 追加したいロケールを選択（例: English (United Kingdom) (en-GB)）
- Fallback locale: フォールバック先を指定（不要なら None (no fallback) のまま）
- Locale settings: 必要に応じてチェック
- Enable this locale in response: Delivery API / Preview API のレスポンスにこのロケールを含める
- Enable editing for this locale: エディターでこのロケールの編集を有効にする
- Allow required fields to be empty for this locale: 必須フィールドが空でも公開可能にする（必須フィールドがあるコンテンツモデルでは有効にしておくと便利）
- 画面上部の Save をクリック
エントリでロケールを有効にする
ロケールを追加しただけでは、エントリのエディターには反映されない場合があります。エントリのサイドバーから有効化します。
- エントリを開き、サイドバーの Active locales セクションにある Edit locales list をクリック
- 「Edit locales list」ダイアログで、追加したロケール（例: English (United Kingdom) (en-GB)）にチェックを入れる
- Save をクリック
フィールドのローカライゼーションを有効にする
コンテンツモデル側で、各フィールドのローカライゼーション設定を有効にする必要があります。
- 上部ナビゲーションの Content model をクリック
- 対象のコンテンツタイプ（例: Tutorial Blog Post）を選択
- ローカライズしたいフィールド（例: Title）の編集ボタンをクリック
- Settings タブを開く
- Field options の中にある Enable localization of this field にチェックを入れる
- Confirm をクリック
- コピーしたい他のフィールド（Body等）にも同様の設定を繰り返す
- 画面上部の Save をクリックしてコンテンツタイプを保存
1. アプリのインストール
- Contentful Web Appにログイン
- 上部メニューから Apps → Marketplace を選択
- 検索バーで「Locale Field Populator」を検索
- アプリの詳細画面が表示される。Features に以下が記載されていることを確認
- Automatically copies field values from a source locale to selected target locales
- Works recursively across all populated fields in an entry
- Ideal for teams managing content in multiple, similar languages like English (US), English (UK), and English (CA)
- 右上の Install をクリック
2. スペースと環境の選択
Install をクリックすると「Select space & environment」ダイアログが表示される。
- Space ドロップダウンからインストール先のスペースを選択
- Environment ドロップダウンから環境を選択
- Continue をクリック
3. コンテンツタイプの割り当て
「Set up Locale Field Populator」画面で、アプリを有効にするコンテンツタイプを選択する。
- Content types ドロップダウンをクリック
- Locale Field Populatorを使いたいコンテンツタイプにチェックを入れる
- 右上の Install をクリックしてセットアップ完了
4. フィールド値の自動コピーを実行
セットアップが完了したら、実際にエントリでLocale Field Populatorを使ってみます。
- Content メニューから、ステップ3で選択したコンテンツタイプのエントリを開く
- エディター画面の右側サイドバーに Locale Field Populator のパネルが表示されていることを確認
- ソースロケール（コピー元）を選択（例: English (US)）
- ターゲットロケール（コピー先）を選択（例: English (UK)）
- Populate ボタンをクリック
- Preview changes 画面が表示される。SourceとTargetの差分が色付きで確認できる。コピーしたくないフィールドがあれば Adopt this field のチェックを外す
- 確認後、Confirm をクリックして適用。完了後はChanges appliedが表示されます。
アプリはエントリ内のすべてのフィールドに対して再帰的に動作し、ソースロケールの値をターゲットロケールに一括コピーします。
気づいたこと
良かった点
- 手作業が激減する: フィールドごとにコピー＆ペーストしたりする作業がワンクリックで完了します。10フィールド以上あるエントリだと、特に便利に感じるんじゃないかと思いました。
- 差分プレビューでフィールドごとに適用を選べる: 実行前に Preview changes 画面が表示され、SourceとTargetの差分が色付きで確認できます。フィールドごとに Adopt this field のチェックで適用対象を選べるので、意図しない上書きを防げます。この点はかなり安心感があると思います。
- 公式アプリの安心感: Contentful公式が開発・メンテナンスしているので、APIの仕様変更にも追従してくれるだろうという安心感があります。サードパーティ製のツールだとメンテナンスが止まるリスクがあるので、この点は大きいかなと思います。
注意すべき点
- 「類似言語」間でのみ動作する: アプリの説明に「Ideal for teams managing content in multiple, similar languages like English (US), English (UK), and English (CA)」とあるとおり、英語バリアント同士のような類似言語間のコピーを想定したアプリのようです。実際に試したところ、EN-USをソースにした場合、ターゲットロケールにはEN-UKやEN-AUなどの英語バリアントのみが表示され、Japanese（ja）のような全く異なる言語はターゲットとして選択できませんでした。EN-US → JA のような異言語間コピーには使えませんでした。
- 「コピー」であって「同期」ではない: 一度コピーした後にソースロケールを更新しても、ターゲットロケールには自動反映されません。あくまで実行時点のスナップショットをコピーする動作のようです。
- フィールドのローカライゼーション設定が有効になっていないフィールドは対象外です。コンテンツモデルの設定で「Enable localization of this field」にチェックが入っているか事前に確認してください。
- フォールバックロケールとの違いを理解しておく: Contentfulのフォールバックロケールは、Content Delivery APIおよびContent Preview APIでの配信時に空のフィールドに対してフォールバック値を返す仕組みです。Locale Field Populatorは実際にフィールド値をコピーするので、目的が異なります。
まとめ
Locale Field Populatorは、Contentfulでの多言語コンテンツ管理における手作業を大幅に削減してくれるアプリだと思いました。特に英語バリアント（EN-US / EN-UK / EN-AU 等）のような類似言語を複数扱うチームにとっては便利なのではないかなと思います。
一方で、類似言語間でのみ動作する（EN-US → JAのような異言語間コピーは不可）という制約や、「同期」ではなく「コピー」である点は押さえておく必要があります。
誰かの参考になれば幸いです。
参考リンク:
