# How to Translate .resx Files in a .NET Project | Vitra.ai > Resx files hold strings, images and files in one XML schema. Translating the wrong node type is what corrupts them as well across the whole state. **Canonical URL**: https://www.vitra.ai/general/translate-resx-files **Source**: This is the Markdown rendering of https://www.vitra.ai/general/translate-resx-files, generated at build time from that page. --- 4 min read # How to Translate .resx Files in a .NET Project Resx files hold strings, images and files in one XML schema. Translating the wrong node type is what corrupts them as well across the whole state. [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Senior Product Manager , Vitra.ai Published Aug 17, 2026 ![How to Translate .resx Files in a .NET Project](https://www.vitra.ai/static/images/blog/translate-resx-files.jpg) In this guide Contributors [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Senior Product Manager Try the workflow, not just the idea. Start with 500 free credits to explore creation, translation and personalization in Vitra Universe. [Start creating free →](https://universe.vitra.ai/auth/sign-up)[Or use a free working template](https://www.vitra.ai/templates) > **Quick answer —** A .resx file is XML holding named resources — strings, but also embedded images and file references. Only string values get translated, the name attribute is the lookup key, and the satellite assembly naming decides whether .NET ever loads the result. ## Not every resource is a string Resx is a general resource container. Most entries are `` nodes holding text, but the same file can hold embedded images, icons and binary blobs referenced through `` with a `mimetype`. A process that treats the whole file as text will attempt to translate a base64-encoded icon. The result is a corrupt resource and a runtime exception. Filter to string nodes before anything else. ## The name attribute is the key `` is what the code requests through the resource manager. The child `` is what a user reads. Same rule as every other resource format, and the same silent failure when it is broken: a missing key falls back to the neutral culture and the string appears in English. ## Satellite assemblies and culture codes .NET compiles translated resx files into satellite assemblies organised by culture — `fr`, `fr-CA`, `pt-BR`. The folder and file naming has to match the culture the application requests. Neutral versus specific cultures matter here. A `fr` resource serves both France and Canada unless a `fr-CA` exists, which is a useful fallback chain and a common source of confusion when a specific culture is expected and a neutral one is found. ## Placeholders are composite format items .NET uses `{0}`, `{1}`, and increasingly interpolated strings. In resx the composite format items must survive exactly, and their order can change for word order while their indices stay bound to their arguments. Braces intended as literal text must be doubled — `{{` — and translations that introduce an unescaped brace throw a format exception at runtime rather than displaying wrongly. ## Designer files are generated `Resources.Designer.cs` is generated from the resx and provides strongly typed access. It should never be edited by hand and never translated. If it appears in a translation scope, the scope is wrong. ## Why the incremental case dominates Enterprise .NET applications carry very large resource sets that change a little each release. [translation memory](https://www.vitra.ai/features/translation-memory) makes the recurring cost proportional to the diff rather than the bundle, and keeps a term identical across every screen that uses it. ## The route through Upload the resx set, filter to string nodes, lock the name attributes, protect format items, translate, and confirm the culture naming on export. [document translation](https://www.vitra.ai/features/document-translation) handles the XML and [quality control](https://www.vitra.ai/features/quality-control) verifies the format items. Schema and naming specifics are on the [resx translation integration](https://www.vitra.ai/integration/resx-translation) page. ## WinForms designers store layout in the resource file In older WinForms projects the designer writes control positions and sizes into the resx alongside the strings. Translated text that runs longer does not reflow, and the control keeps whatever width the designer recorded. That is why some translated desktop applications show truncated button labels. The string is correct and the layout value sitting beside it was never revisited. ## Where to start Build one satellite assembly and switch the culture at runtime. If the strings change, the naming is right and the rest is volume. ## FAQ **What should be translated in a .resx file?** Only string values. The same file can hold embedded images and binary blobs, and a process that treats everything as text will try to translate a base64-encoded icon, producing a corrupt resource. **What is the name attribute for?** It is the lookup key the resource manager requests. Changing it means the key is not found, so .NET falls back to the neutral culture and the string appears in English with no error. **How does .NET decide which translation to load?** Through satellite assemblies organised by culture code. A neutral culture like fr serves both France and Canada unless a specific fr-CA exists, which is a useful fallback and a frequent source of confusion. **Why does a translation throw a format exception?** Usually an unescaped brace. Composite format items like 0 must survive exactly and literal braces must be doubled, so a translation that introduces a stray brace fails at runtime rather than displaying wrongly. Continue the topic ## Related guides Read the next explanation, example or review step for this subject. General [How to Translate Android strings.xml Files Correctly](https://www.vitra.ai/general/translate-android-strings-xml) Android's resource system does most of the work. The failures are escaping, plurals, and format arguments that silently land in the wrong order as well. [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Aug 17, 2026 General [How to Translate .ASC Files Without Corrupting Data](https://www.vitra.ai/general/translate-asc-files) An .asc file can be plain text, an armoured signature or exported instrument data. Identify which before translating anything across the whole state. [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Aug 17, 2026 General [How to Translate AsciiDoc Files and Keep the Build](https://www.vitra.ai/general/translate-asciidoc-files) AsciiDoc hides more syntax in plain text than Markdown does. Attributes, includes and conditionals all look like prose and none of it is as well. [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Aug 17, 2026 [Browse the topic guides](https://www.vitra.ai/blog/topics) --- ## Structured data ```json { "@context": "https://schema.org", "@type": "Article", "mainEntityOfPage": { "@type": "WebPage", "@id": "https://www.vitra.ai/general/translate-resx-files" }, "headline": "How to Translate .resx Files in a .NET Project", "image": [ { "@type": "ImageObject", "url": "https://www.vitra.ai/static/images/blog/translate-resx-files.jpg" } ], "datePublished": "2026-08-17T00:00:00.000Z", "dateModified": "2026-08-17T00:00:00.000Z", "author": [ { "@type": "Person", "name": "Samhitha J Bhatt", "url": "https://www.vitra.ai/author/samhitha" } ], "publisher": { "@type": "Organization", "name": "Vitra.ai", "logo": { "@type": "ImageObject", "url": "https://www.vitra.ai/static/images/vitra-v-logo.png" } }, "description": "Resx files hold strings, images and files in one XML schema. Translating the wrong node type is what corrupts them as well across the whole state." } ``` ```json { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.vitra.ai" }, { "@type": "ListItem", "position": 2, "name": "Translation & content workflows", "item": "https://www.vitra.ai/general" }, { "@type": "ListItem", "position": 3, "name": "How to Translate .resx Files in a .NET Project", "item": "https://www.vitra.ai/general/translate-resx-files" } ] } ``` ```json { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What should be translated in a .resx file?", "acceptedAnswer": { "@type": "Answer", "text": "Only string values. The same file can hold embedded images and binary blobs, and a process that treats everything as text will try to translate a base64-encoded icon, producing a corrupt resource." } }, { "@type": "Question", "name": "What is the name attribute for?", "acceptedAnswer": { "@type": "Answer", "text": "It is the lookup key the resource manager requests. Changing it means the key is not found, so .NET falls back to the neutral culture and the string appears in English with no error." } }, { "@type": "Question", "name": "How does .NET decide which translation to load?", "acceptedAnswer": { "@type": "Answer", "text": "Through satellite assemblies organised by culture code. A neutral culture like fr serves both France and Canada unless a specific fr-CA exists, which is a useful fallback and a frequent source of confusion." } }, { "@type": "Question", "name": "Why does a translation throw a format exception?", "acceptedAnswer": { "@type": "Answer", "text": "Usually an unescaped brace. Composite format items like {0} must survive exactly and literal braces must be doubled, so a translation that introduces a stray brace fails at runtime rather than displaying wrongly." } } ] } ```