Source
One source key changes
Smart detection isolates the delta before any provider call.
Localize your repo on every commit.
Three secrets, four lines, and your repo is multilingual on the next push.
Supports
0 npm-audit issues
240+ tests
Azure, AWS, GoogleNode 20 / 22 / 24
Built for shipping
Translation as a workflow, not a chore.
Drop the action into your existing CI, point it at Azure, AWS, or Google, and let your repo speak every language you target.
Default in v3.2
Smart change detection
A compact .github/resource-translator-state.json tracks parser keys, source hashes, and translation-affecting settings. The action skips stable keys, preserves manual target edits, and logs every decision with rule codes. Use snapshotOnly to bootstrap existing translations without a provider call.
Most runs translate only the changed keys
Six file formats
Round-trips .resx, .xliff, .po, .json, .ini, and .restext with byte-stable formatting.
Repo-level config
Drop a .github/resource-translator.yml file for include globs, glossaries, and Custom Translator categories.
Glossary-aware
Lock brand names and product terms with smart word-boundary regex that handles C++, .NET, and friends.
Dry-run + soft-fail
Preview translations without writing files, or surface every error as a warning while you iterate.
PR-friendly outputs
summary-title, summary-details, and has-new-translations slot directly into create-pull-request.
Azure, AWS & Google
Pick one provider per run. Each is driven by its official SDK (@azure-rest/ai-translation-text, @aws-sdk/client-translate, @google-cloud/translate) with automatic retries on 408/429/5xx - no hand-rolled HTTP. esbuild-bundled, audit-clean.
Copy. Paste. Translate.
Resource Translator opens machine-translated pull requests for your resource files using Azure, AWS, or Google - one unified action, one provider per run, official SDKs under the hood.
Get startedname: translateon: push: paths: ["**/*.en.resx", "**/*.en.json"]
permissions: contents: write pull-requests: write
jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v5 - id: translator uses: IEvangelist/resource-translator@v3 with: sourceLocale: en provider: | azure: subscriptionKey: ${{ secrets.KEY }} endpoint: ${{ secrets.ENDPOINT }} region: ${{ secrets.REGION }} toLocales: '["fr","de","es","ja"]'
- uses: peter-evans/create-pull-request@v7 with: title: Update translationsReady to localize on autopilot?
One provider key - Azure, AWS, or Google - and one workflow file. Resource Translator handles the rest.