Skip to main content
Download translation files from Entri and write them to your local project. By default, all target languages configured in your Entri project are pulled.

​
Usage

nt3 pull [options]
# alias: nt3 down

​
Examples

# Pull all target languages
nt3 pull

# Pull a single language
nt3 pull -l fr

# JSON output for CI/CD
nt3 pull --json

​
Options

FlagDescription
-l, --language <lang>Pull a specific language only (e.g., -l fr)
--jsonOutput results as JSON

​
How pull works

nt3 pull fetches translations from the Entri export API and writes them to the file paths defined in your .nt3.yml. The {lang} placeholder in each file pattern is replaced with the language code. For example, with this config: 
file_patterns:
  - path: "src/locales/{lang}.json"
    format: json-nested
Running nt3 pull with French and Dutch configured as target languages writes:
  • src/locales/fr.json
  • src/locales/nl.json
If the target directory does not exist, it is created automatically.

​
Pulling a single language

Use -l to pull one language at a time instead of all configured languages: 
nt3 pull -l de
This is useful when you only need to refresh a specific locale, or when running language-specific jobs in parallel.

​
JSON output

With --json, the command suppresses progress output and prints a structured result: 
{
  "success": true,
  "files": [
    {
      "language": "fr",
      "path": "src/locales/fr.json",
      "format": "json-nested"
    },
    {
      "language": "nl",
      "path": "src/locales/nl.json",
      "format": "json-nested"
    }
  ],
  "errors": []
}
On failure, the relevant file entry includes an error field and the process exits with code 1.

​
What gets exported

The export reflects the current state of translations in Entri — all keys with their latest translated values. Keys that have not been translated yet are included with their source-language fallback value, depending on the export format. To ensure translations are up to date before pulling, run nt3 translate --all first, or trigger translation from the Entri dashboard.