Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 32 additions & 14 deletions 14/umbraco-forms/developer/localization.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,17 +12,35 @@ When an editor chooses a language for their account, Umbraco CMS will render app

Umbraco Forms ships with translations for the following languages:

- Czech (`cs-cz.xml`)
- Danish (`da-dk.xml`)
- Spanish (`es-es.xml`)
- French (`fr-fr.xml`)
- Italian (`it-it.xml`)
- Polish (`pl-pl.xml`)
- UK English (`en-gb.xml`)
- US English (`en-us.xml`)

If the language you require does not exist, it's possible to create your own by duplicating the default `en-us.xml` file. You can then save it with the appropriate culture code for the language you need and replace the English text with the translated version.

As of Forms 10, the file no longer exists on disk and is shipped as part of the `Umbraco.Forms.StaticAssets` NuGet package. You can open this package, either locally using [Nuget Package Explorer](https://apps.microsoft.com/store/detail/nuget-package-explorer/9WZDNCRDMDM3?hl=en-gb&gl=gb&rtc=1), or [online](https://www.nuget.org/packages/Umbraco.Forms.StaticAssets/) by clicking the "Open in NuGet Package Explorer" link. You'll find the file at `staticwebassets/Lang/en-us.xml`.

Once translated, the new file should be saved into the `App_Plugins/UmbracoForms/app/lang/` folder.
- Czech (`cs-cz.js`)
- Danish (`da-dk.js`)
- Spanish (`es-es.js`)
- French (`fr-fr.js`)
- Italian (`it-it.js`)
- Polish (`pl-pl.js`)
- UK English (`en-gb.js`)
- US English (`en-us.js`)

If the language you require does not exist, it's possible to create your own by duplicating the default `en-us.js` file. You can then save it with the appropriate culture code for the language you need and replace the English text with the translated version.

As of Forms 10, the file no longer exists on disk and is shipped as part of the `Umbraco.Forms.StaticAssets` NuGet package. You can open this package, either locally using [Nuget Package Explorer](https://apps.microsoft.com/store/detail/nuget-package-explorer/9WZDNCRDMDM3?hl=en-gb&gl=gb&rtc=1), or [online](https://www.nuget.org/packages/Umbraco.Forms.StaticAssets/) by clicking the "Open in NuGet Package Explorer" link. You'll find the file at `staticwebassets/en-us.js`.

Once translated, the new file should be saved somewhere in the `App_Plugins` folder for example `App_Plugins/UmbracoFormsLocalization/`. The final step is to register the localization file. The can be done by creating a `umbraco-package.json` like so:

```json
{
"$schema": "../../umbraco-package-schema.json",
"name": "Umbraco.Forms.Extensions",
"extensions": [
{
"type": "localization",
"alias": "UmbracoForms.Localize.NlNL",
"name": "Dutch (Netherlands)",
"meta": {
"culture": "nl-nl"
},
"js": "/App_Plugins/UmbracoFormsLocalization/nl-nl.js"
}
]
}
```