Skip to main content

Fetching text

Once you’ve installed, authenticated, and configured the CLI, you’ll be able to pull down up-to-date text by running the CLI:
npx @dittowords/cli pull
This will fetch the latest text values from Ditto and write them to the output directory as specified by your config file. For more information on the structure of files created by Ditto, see files. Because the Ditto CLI updates your string files locally, you can continue to manage it as you would with any other product update (push it to staging, commit changes to a branch, etc.). Custom config file location By default, the pull command will look for a config file in ./ditto/config.yml (relative to where you run the CLI command). To use a config file from a different location, provide the path via -c or --config flag:
npx @dittowords/cli pull -c ./ditto/path/to/myConfig.yml
Legacy support Version 5.x of the CLI is set up to pull text from the latest version of Ditto by default. However, it still contains support for all features from 4.x via the --legacy flag. To run the CLI in legacy mode, add the --legacy flag to any command that was supported by v4.5.2. View the legacy documentation for full details.
npx @dittowords/cli --legacy help
npx @dittowords/cli --legacy pull