HomeSandboxShowcaseAppDocBlog
    • EnglishEnglish
      EN
    • русскийRussian
      RU
    • 日本語Japanese
      JA
    • françaisFrench
      FR
    • 한국어Korean
      KO
    • 中文Chinese
      ZH
    • españolSpanish
      ES
    • DeutschGerman
      DE
    • العربيةArabic
      AR
    • italianoItalian
      IT
    • British EnglishBritish English
      EN-GB
    • portuguêsPortuguese
      PT
    • हिन्दीHindi
      HI
    • TürkçeTurkish
      TR
    • polskiPolish
      PL
    • IndonesiaIndonesian
      ID
    • Tiếng ViệtVietnamese
      VI
    • українськаUkrainian
      UK
    /
    Filter docs by framework
    Alt+←
    Why Intlayer ?
    Get Started
    Concept
    • How Intlayer Works
    • Configuration
    • TestFillBuildWatchExtractLoginPushPullConfigurationListVersionEditorLiveDebugDoc ReviewDoc TranslateSDK
    • Visual Editor
    • CMS
    • CI/CD Integration
    • TranslationPluralEnumerationConditionGenderInsertionFileNestingMarkdownHTMLFunction Fetching
    • Per Locale File
    • Compiler
    • Auto Fill
    • Testing
    • Bundle Optimization
    Environment
    • Next.js 14 and App Router
      Next.js 15
      Next.js no locale path
      Next.js and Page Router
      Compiler
    • Tanstack Start Solid
    • Astro and React
      Astro and Svelte
      Astro and Vue
      Astro and Solid
      Astro and Preact
      Astro and Lit
      Astro and Vanilla JS
    • React Router v7
      React Router v7 (fs-routes)
      Compiler
    • Nuxt and Vue
    • Vite and Solid
    • SvelteKit
    • Vite and Preact
    • Vite and Vanilla JS
    • Vite and Lit
    • Angular 19 (Webpack)
      Analog
    • React CRA
    • React Native and Expo
    • Express.js
      NestJS
      Fastify
      Hono
      Adonis
    • Lynx and React
    Plugins
    • JSON
    • gettext (.po)
    VS Code Extension
    Agent
    • MCP Server
    • Agent skills
    Releases
    • v8
    • v7
    • v6
    Benchmark
    • Next.js
    • TanStack
    • Vue
    • Solid
    • Svelte
    Blog
    Ask a question
    1. Documentation
    2. Concept
    3. CLI
    4. Push
    Creation:2024-08-11Last update:2025-11-22
    Reference this doc to your favorite AI assistant
    ChatGPT
    Claude
    DeepSeek
    Google AI mode
    Gemini
    Perplexity
    Mistral
    Grok

    Ask your question and get a summary of the document by referencing this page and the AI provider of your choice

    Edit this doc

    If you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.

    GitHub link to the documentation
    Copy

    Copy doc Markdown to clipboard

    Push Dictionaries

    bash
    Copy code

    Copy the code to the clipboard

    npx intlayer dictionary push

    If intlayer editor is installed, you can also push dictionaries to the editor. This command will allow to make the dictionaries available to the editor. By this way, you can share your dictionaries with your team and edit your content without editing the code of your application.

    Aliases:

    • npx intlayer dictionaries push
    • npx intlayer dictionary push
    • npx intlayer dic push

    Arguments:

    Dictionary options:

    • -d, --dictionaries: ids of the dictionaries to pull. If not specified, all dictionaries will be pushed.

      Example: npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id
    • --dictionary: ids of the dictionaries to pull (alias for --dictionaries).

      Example: npx intlayer dictionary push --dictionary my-dictionary-id my-other-dictionary-id

    Configuration options:

    • --base-dir: Specify the base directory for the project. To retrieve the intlayer configuration, the command will look for the intlayer.config.{ts,js,json,cjs,mjs} file in the base directory.

      Example: npx intlayer dictionary push --env-file .env.production.local
    • --no-cache: Disable the cache.

      Example: npx intlayer build --no-cache

    Environment variables options:

    • --env: Specify the environment (e.g., development, production). Useful in the case you use environment variables in your intlayer configuration file.
    • --env-file: Provide a custom environment file to load variables from. Useful in the case you use environment variables in your intlayer configuration file.

      Example: npx intlayer dictionary push --env-file .env.production.local
      Example: npx intlayer dictionary push --env production

    Output options:

    • -r, --delete-locale-dictionary: Skip the question that asking to delete the locales directories once the dictionaries are pushed, and remove them. By default, if the dictionary is defined locally, it will overwrite distant dictionaries content.

      Example: npx intlayer dictionary push -r
      Example: npx intlayer dictionary push --delete-locale-dictionary
    • -k, --keep-locale-dictionary: Skip the question that asking to delete the locales directories once the dictionaries are pushed, and keep them. By default, is the dictionary is defined locally, it will overwrite distant dictionaries content.

      Example: npx intlayer dictionary push -k
      Example: npx intlayer dictionary push --keep-locale-dictionary

    Preparation options:

    • --build: Build the dictionaries before pushing to ensure the content is up to date. True will force the build, false will skip the build, undefined will allow using the cache of the build.

    Log options:

    • --verbose: Enable verbose logging for debugging. (default to true using CLI)

    Git options:

    • --git-diff: Only run on dictionaries that includes changes from base (default origin/main) to current branch (default: HEAD).
    • --git-diff-base: Specify the base reference for git diff (default origin/main).
    • --git-diff-current: Specify the current reference for git diff (default: HEAD).
    • --uncommitted: Include uncommitted changes.
    • --unpushed: Include unpushed changes.
    • --untracked: Include untracked files.

      Example: npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD
      Example: npx intlayer dictionary push --uncommitted --unpushed --untracked
    Login
    Pull
    Alt+→

    In this page

      Discussions are anonymous and regularly reviewed to address common issues. Feel free to share feature ideas, feedback on the documentation, or anything related to Intlayer, we use this input to shape our roadmap and improve the product.

      npx intlayer dictionary push