Translation File Formats

Paraglide JS works with any message syntax and file format via inlang plugins. This means you can use JSON, YAML, i18next format, or any other format that has a plugin.

graph LR; subgraph "Pipeline" A[Inlang Project] -->|Opened by| B[Paraglide Compiler] B -->|Compiles| C[Code] end A <-.->|Imports & Exports| D[Inlang Plugin] D <-.->|Reads & Writes| E[Translation File]

Choosing a Plugin

Plugin	Best For	File Format
Inlang Message Format	New projects, full inlang feature support	messages/{locale}.json
i18next	Migrating from i18next	locales/{locale}.json
JSON	Simple key-value translations	{locale}.json

Browse all plugins at inlang.com/c/plugins.

Message Syntax Examples

Inlang Message Format

messages/en.json

{
	"greeting": "Hello {name}!",
	"items_count": "{count, plural, one {# item} other {# items}}",
	"welcome_message": "Welcome to {appName}, {username}!"
}

messages/de.json

{
	"greeting": "Hallo {name}!",
	"items_count": "{count, plural, one {# Artikel} other {# Artikel}}",
	"welcome_message": "Willkommen bei {appName}, {username}!"
}

i18next Format

locales/en.json

{
	"greeting": "Hello {{name}}!",
	"items_count": "{{count}} item",
	"items_count_plural": "{{count}} items"
}

Simple JSON

en.json

{
	"greeting": "Hello!",
	"goodbye": "Goodbye!"
}

Installing a Plugin

Add the plugin URL to the modules array in your project.inlang/settings.json:

[!NOTE]Refer to each plugin's documentation for specific configuration options.

{
  "baseLocale": "en",
  "locales": ["en", "de"],
  "modules": [
-    "https://cdn.jsdelivr.net/npm/@inlang/plugin-message-format@4.4.0/dist/index.js"
+    "https://cdn.jsdelivr.net/npm/@inlang/plugin-i18next@6.0.11/dist/index.js"
  ]
}

Using Multiple Plugins

You can use multiple plugins to support different file formats in the same project:

{
	"baseLocale": "en",
	"locales": ["en", "de"],
	"modules": [
		"https://cdn.jsdelivr.net/npm/@inlang/plugin-message-format@4.4.0/dist/index.js",
		"https://cdn.jsdelivr.net/npm/@inlang/plugin-i18next@6.0.11/dist/index.js"
	]
}

This is useful when migrating from one format to another, or when different parts of your app use different translation formats.