Ask your question and get a summary of the document by referencing this page and the AI provider of your choice
By integrating the Intlayer MCP Server to your favourite AI assistant can retrieve all the doc directly from ChatGPT, DeepSeek, Cursor, VSCode, etc.
See MCP Server docIf you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.
GitHub link to the documentationCopy doc Markdown to clipboard
Documentation: getLocalizedUrl Function in intlayer
Description
The getLocalizedUrl function generates a localized URL by prefixing the given URL with the specified locale. It handles both absolute and relative URLs, ensuring that the correct locale prefix is applied based on the configuration.
Parameters
url: string
- Description: The original URL string to be prefixed with a locale.
- Type: string
currentLocale: Locales
- Description: The current locale for which the URL is being localized.
- Type: Locales
locales: Locales[]
- Description: Optional array of supported locales. By defaults, the configured locales in the project are provided.
- Type: Locales[]
- Default: Project Configuration
defaultLocale: Locales
- Description: The default locale for the application. By defaults, the configured default locale in the project are provided.
- Type: Locales
- Default: Project Configuration
prefixDefault: boolean
- Description: Whether to prefix the URL for the default locale. By defaults, the configured value in the project are provided.
- Type: boolean
- Default: Project Configuration
Returns
- Type: string
- Description: The localized URL for the specified locale.
Example Usage
Relative URLs
Copy the code to the clipboard
import { getLocalizedUrl, Locales } from "intlayer";getLocalizedUrl( "/about", Locales.FRENCH, [Locales.ENGLISH, Locales.FRENCH], Locales.ENGLISH, false);// Output: "/fr/about" for the French locale// Output: "/about" for the default (English) locale
Absolute URLs
Copy the code to the clipboard
getLocalizedUrl( "https://example.com/about", Locales.FRENCH, // Current Locale [Locales.ENGLISH, Locales.FRENCH], // Supported Locales Locales.ENGLISH, // Default Locale false // Prefix Default Locale); // Output: "https://example.com/fr/about" for the FrenchgetLocalizedUrl( "https://example.com/about", Locales.ENGLISH, // Current Locale [Locales.ENGLISH, Locales.FRENCH], // Supported Locales Locales.ENGLISH, // Default Locale false // Prefix Default Locale); // Output: "https://example.com/about" for the EnglishgetLocalizedUrl( "https://example.com/about", Locales.ENGLISH, // Current Locale [Locales.ENGLISH, Locales.FRENCH], // Supported Locales Locales.ENGLISH, // Default Locale true // Prefix Default Locale); // Output: "https://example.com/en/about" for the English
Unsupported Locale
Copy the code to the clipboard
getLocalizedUrl( "/about", Locales.ITALIAN, // Current Locale [Locales.ENGLISH, Locales.FRENCH], // Supported Locales Locales.ENGLISH // Default Locale); // Output: "/about" (no prefix applied for unsupported locale)
Edge Cases
No Locale Segment:
- If the URL does not contain any locale segment, the function safely prefixes the appropriate locale.
Default Locale:
- When prefixDefault is false, the function does not prefix the URL for the default locale.
Unsupported Locales:
- For locales not listed in locales, the function does not apply any prefix.
Usage in Applications
In a multilingual application, configuring the internationalization settings with locales and defaultLocale is critical for ensuring the correct language is displayed. Below is an example of how getLocalizedUrl can be used in an application setup:
Copy the code to the clipboard
import { Locales, type IntlayerConfig } from "intlayer";// Configuration for supported locales and default localeexport default { internationalization: { locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH], defaultLocale: Locales.ENGLISH, },} satisfies IntlayerConfig;export default config;
The above configuration ensures that the application recognizes ENGLISH, FRENCH, and SPANISH as supported languages and uses ENGLISH as the fallback language.
Using this configuration, the getLocalizedUrl function can dynamically generate localized URLs based on the user's language preference:
Copy the code to the clipboard
getLocalizedUrl("/about", Locales.FRENCH); // Output: "/fr/about"getLocalizedUrl("/about", Locales.SPANISH); // Output: "/es/about"getLocalizedUrl("/about", Locales.ENGLISH); // Output: "/about"
By integrating getLocalizedUrl, developers can maintain consistent URL structures across multiple languages, enhancing both user experience and SEO.
Doc History
Version | Date | Changes |
---|---|---|
5.5.10 | 2025-06-29 | Init history |