CLI Commands

move

Move a translation key to another layer, to another key path, or both, carrying every locale that defines it.

Synopsis

the-i18n-cli move --layer <layer> --key <key>

Flags

FlagTypeRequiredDefaultDescription
--layerstringyes—Layer the key lives in today, from discover. Example: "app-admin".
--keystringyes—Dot-separated key path to move. Example: "calendar.views.save".
--toLayerstringno—Layer to move it to, from discover. Example: "root". Omit (or repeat layer) to rename the key within its current layer, which then requires newKey.
--newKeystringno—Key path to give it. Example: "common.actions.save". Omit to keep the current path, which then requires toLayer.
--dryRunbooleannofalseReturn the plan without writing any files. Default: false.
Copyright © 2026