diff --git a/translations.mdx b/translations.mdx
index a3e272b54..85e235945 100644
--- a/translations.mdx
+++ b/translations.mdx
@@ -48,11 +48,46 @@ You can initiate a complete translation from the translations page in your [dash
5. Repeat the process for each language that you want to translate to.
- An automated translation is stored under a directory named after the [language code](/navigation#languages) that you have selected.
-
- Custom directory names for translations are not supported at this time.
+ By default, automated translations are stored under a directory named after the [language code](/navigation#languages) that you have selected. However, you can now configure custom directory names for your translations if needed.
+## Custom Directory Names
+
+You can configure custom directory names for your translations by modifying your `docs.json` file. While the default behavior uses language codes (e.g., `es` for Spanish, `fr` for French), you can specify custom paths for each language.
+
+To configure custom directory names, update your `docs.json` file with custom paths in the languages configuration:
+
+```json
+{
+ "languages": [
+ {
+ "name": "English",
+ "code": "en"
+ },
+ {
+ "name": "Español",
+ "code": "es",
+ "path": "spanish"
+ },
+ {
+ "name": "Français",
+ "code": "fr",
+ "path": "french"
+ }
+ ]
+}
+```
+
+In this example:
+- Spanish translations will be stored in a `spanish/` directory instead of `es/`
+- French translations will be stored in a `french/` directory instead of `fr/`
+- English (the base language) doesn't require a custom path
+
+You can use any valid directory name for your custom paths, such as:
+- Full language names: `spanish`, `french`, `german`
+- Regional variants: `spanish-mx`, `english-uk`
+- Custom naming schemes: `docs-es`, `content-fr`
+
## Ongoing Translations
After adding a translation to your `docs.json` file, any future changes to your documentation are automatically translated as long as you maintain a subscription to the translation add-on for your configured languages.
@@ -61,7 +96,7 @@ The ongoing translation process follows this sequence:
1. A member of your organization makes changes to the documentation in your repository.
2. When the changes are pushed or merged into your main branch, the ongoing translation job is triggered.
-3. The translation job updates, removes, or creates the required files in all subscribed languages based on your `docs.json` file.
+3. The translation job updates, removes, or creates the required files in all subscribed languages based on your `docs.json` file configuration, using either the default language code directories or your custom directory names.
4. The translation job creates a separate branch and pull request containing the translated changes for your review.
@@ -121,4 +156,4 @@ We recommend promptly reviewing and merging translation pull requests so that yo
The translation service does not support custom translation rules for specific terms or phrases. We are developing this feature for a future release.
-
+
\ No newline at end of file