--- schema_version: "1" id: 99f64df17aea9448488462de0f02afadf1a037e8bb59d3d4c1ff6bc100b26ecc title: Agentforce Language Support collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_language_support.md canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_language_support.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 545c3df4007d930ebf7bc2317d9946ad9957815262a017983e4baa31c592f940 description: Learn about supported languages, multi-language setup, and agent testing with Agentforce Builder. products: - Agentforce - Cross Cloud release: "264" --- # Agentforce Language Support Learn about supported languages, multi-language setup, and agent testing with Agentforce Builder. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png) Note Adaptive language mode is a beta service that is subject to the Beta Services Terms at [Agreements - Salesforce.com](https://www.salesforce.com/company/legal/agreements/) or a written Unified Pilot Agreement if executed by Customer, and applicable terms in the [Product Terms Directory](https://ptd.salesforce.com/). Use of this beta service is at the Customer's sole discretion. ## Agentforce Supported Languages Languages are tested on the agent’s ability to perform standard actions and retrieve information in that language for Agentforce (Default), Agentforce Employee Agent, and Agentforce Service Agent types only. Languages in beta may have some inconsistencies when retrieving information, so plan to test your agent and review its responses carefully. Language availability for voice-enabled agents can differ from the agentforce supported languages. For a list of supported spoken languages for voice-enabled agents, see [Language Support for Agentforce Voice](https://help.salesforce.com/s/articleView?id=ai.agentforce_voice_considerations.htm&release=264.0.0&type=5).

Language	Code
English	`en_AU`
	`en_GB`
	`en_US`
Afrikaans (Beta)	af
Arabic (Beta)	ar
Armenian (Beta)	hy
Bengali (Beta)	bn
Bosnian (Beta)	bs
Bulgarian	bg
Catalan	`ca`
Chinese Simplified	`zh_CN`
Chinese Traditional	`zh_TW`
Croatian	`hr`
Czech	`cs`
Dutch	`nl-NL`
Dutch	`nl-BE`
Danish	`da`
Estonian	et
Farsi (Beta)	fa
Finnish	`fi`
French	`fr_CA`
French	`fr_FR`
German	`de`
Greek	el
Gujarati (Beta)	gu
Hebrew (Beta)	he
Hindi	hi
Hungarian	hu
Icelandic (Beta)	is
Indonesian	id
Italian	`it`
Japanese	`ja`
Kannada (Beta)	kn
Kazakh (Beta)	kk
Korean	`ko`
Latvian (Beta)	lv
Lithuanian (Beta)	lt
Macedonian (Beta)	mk
Malay	`ms`
Malayalam (Beta)	ml
Marathi (Beta)	mr
Norwegian	`no`
Polish	pl
Portuguese	`pt_BR`
Portuguese	`pt_PT`
Punjabi (Beta)	pa
Romanian	ro
Russian (Beta)	ru
Serbian (Beta)	sr
Slovak (Beta)	sk
Spanish	`es_ES`
Spanish	`es_MX`
Swedish	`sv`
Tagalog	`tl`
Tamil (Beta)	ta
Te reo (Beta)	mi
Telugu (Beta)	te
Thai	`th`
Turkish	`tr`
Ukrainian (Beta)	uk
Urdu (Beta)	ur
Vietnamese	`vi`

For instructions on adding languages to your agent, see [Update Language Settings](https://help.salesforce.com/s/articleView?id=ai.copilot_setup_tone.htm&release=264.0.0&type=5 "Change the language and tone of your agent’s messages to better suit your company’s brand.") for more information. Thoroughly test your agent’s language settings in Agentforce Builder to ensure consistent behavior. Try changing EndUserLanguage in the Variables tab and see how your agent responds. See [Test Your Agent in Agentforce Builder](https://help.salesforce.com/s/articleView?id=ai.agent_test_in_builder.htm&release=264.0.0&type=5 "Manually testing your agent in Agentforce Builder provides a detailed, step-by-step trace of your agent's interactions and processes. Use the Preview panel to chat with your agent, then review subagent selection, action execution, and reasoning on the Interaction Summary panel. For more details about any step, converse with the Agentforce Assistant.") for more information. ## How It Works Agentforce architecture is designed to handle language variations by using several key variables and processes. These components ensure that your agents interpret multilingual user inputs accurately and respond in the correct language. Agentforce uses three main language settings: - **End User Language:** This setting represents the user's input language. Its value is explicitly defined by the agent channel (or client). How this setting is populated depends on the type of agent channel being used. - For agents connected to the Agentforce panel in the Lightning Experience (for example, Agentforce Employee agents), the end-user language is set from the Salesforce user's language settings for the org. See [Edit Your Language and Locale Settings](https://help.salesforce.com/s/articleView?id=xcloud.usersetup_lang_time_zone.htm&type=5&language=en_US). - For agents connected to Enhanced Chat v1 (for example, Agentforce Service agents), the admin sets up a pre-chat field that determines the end-user language. See [Use Additional Languages in Enhanced Chat v1 Conversations](https://help.salesforce.com/s/articleView?id=ai.service_agent_languages.htm&release=264.0.0&type=5 "Reach more customers and employees with a multi-language agent. After you select additional languages in your agent’s language settings and set up an Enhanced Chat channel, finish setting up additional languages for your agent."). - For agents connected to other channels (for example, Agentforce Lead Nurturing), you can set the end-user language by using the Agent API. See [Send Agent Variables with the Agent API](https://developer.salesforce.com/docs/ai/agentforce/guide/agent-api-variables.html). - **Agent Default Language:** This is the primary or fallback language that you specify for an agent. An agent uses the default language if no language is detected at the start of a session or if the detected language isn’t supported. See [Update Language Settings](https://help.salesforce.com/s/articleView?id=ai.copilot_setup_tone.htm&release=264.0.0&type=5 "Change the language and tone of your agent’s messages to better suit your company’s brand."). - **Agent Allowed Languages:** This is a set of secondary supported languages you specify that an agent can switch to based on language detection. See [Update Language Settings](https://help.salesforce.com/s/articleView?id=ai.copilot_setup_tone.htm&release=264.0.0&type=5 "Change the language and tone of your agent’s messages to better suit your company’s brand."). ## Adaptive Language Mode (Beta) Adaptive language mode changes how an agent chooses a response language. The agent detects the language of each incoming message and responds in that language, including languages that aren't in the agent's Allowed Languages list. The agent can use any language its AI model supports. Without adaptive language mode, an agent responds its default language or allowed languages. Adaptive language mode is available only in Agentforce Builder. It isn't available for voice-enabled agents. Response language, timing, and quality depend on the AI model's language detection and support. ## Example: System Messages and End User Language When you set up your agent, you define [System Messages](https://help.salesforce.com/s/articleView?id=ai.copilot_setup_system_messages.htm&release=264.0.0&type=5 "Agent-level instructions provide your agent with guidance on how to interact in all situations, including any rules it should follow. Your agent sends system messages, such as welcome and error messages, when your users begins chatting with an agent and if they encounter system errors.") for your agent. These include a Welcome Message, an Error Message, and (for Service Agents) an Escalation Message. These messages are written in a single language. At the start of the chat session, Agentforce decides whether or not to translate the System Messages based on the three main language settings. - If the **End User Language** matches the **Agent Default Language**, no translation occurs and the System Messages are output as initially written. - If the settings do not match, Agentforce checks if the **End User Language** is an **Agent Secondary Language**. If it is, then Agentforce translates the System Messages into the **End User Language**. - If the **End User Language** is neither an **Agent Default Language** nor an **Agent Secondary Language**, the **Agent Default Language** will be used. No translation occurs and the System Messages are output as initially written. Expected Behavior:

Example	Agent Settings	System Message Language
1	System Message is written in English Agent Default Language set to English Agent Secondary Language is empty End User Language is set to French	English because only English is allowed for the agent.
2	System Message is written in English, Agent Default Language set to English Agent Secondary Language set to French End User Language is set to French	French because End User Language is different from Agent Default Language, and End User Language is available as an Agent Secondary Language.
3	System Message is written in French Agent Default Language set to English Agent Secondary Language set to French End User Language is set to English	French because the Agent Default Language is the same as the End User Language.

## Example: Language Switching with Multiple Configured Languages ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png) Note Only agents created in the [New Agentforce Builder](https://help.salesforce.com/s/articleView?id=ai.agent_builder_intro.htm&release=264.0.0&type=5 "Build context-aware agents with the predictability that your business demands and the flexibility that LLMs make possible.") support Language Switching. When an agent is configured with multiple languages, the agent prioritizes the language of the user’s input within a conversation if it’s one of the configured languages. For example, consider an agent configured with English as the default language and Portuguese and Spanish as additional languages. - At the start of the session, the end user's language is set to English. - The user asks a question in Spanish, and the agent responds in Spanish. - The user then asks a question in English (in the same conversation), and the agent switches and responds in English, even though the user’s default language is Spanish. - The user then asks a question in Portuguese (in the same conversation), and the agent switches again and responds in Portuguese. - When the agent executes an action, action outputs are in the end user language (English) throughout the entire session. But the agent's response, which wraps around the action output, is dynamic. So it's possible to see mixed-language responses, like "Asunto: Issues with Canvas." ![In this chat transcript example, notice how the agent responds in the same language as each of the user’s questions, even when the user alternates between Spanish, English, and Portuguese.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/agent_languages_ex1.png) The agent respects the languages it’s configured to understand. If a user asks a question in a language the agent is not configured for, the agent may not provide an answer in that language. Instead, it explains that it can’t respond in the user’s language. For example, if a user asks a question in Italian and the agent isn’t configured to use Italian, the agent responds in Italian to explain the languages it supports. ![Unsupported Language Handling: The user asks in Italian, “What is my last open case?” The agent replies in Italian, but only to say, “I’m sorry, but I can only answer in English, Portuguese, or Spanish. Could you repeat your question in one of these languages?”](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/agent_languages_ex2.png) This behavior ensures the agent is responsive to the immediate language of the user’s message, while also maintaining boundaries for languages it isn’t set up to handle. #### See Also - [Agentforce Considerations](https://help.salesforce.com/s/articleView?id=ai.copilot_considerations.htm&release=264.0.0&type=5 "Carefully review the support, limits, and considerations for AI agents.") - [Supported Languages in Prompt Template Responses](https://help.salesforce.com/s/articleView?id=ai.prompt_builder_localize_responses.htm&release=264.0.0&type=5 "A prompt template can use any language that Prompt Builder offers. Supported languages are optimized for business-appropriate phrasing and are integrated with the Einstein Trust Layer to use its data masking and toxicity scoring features.") - [Einstein Trust Layer Region and Language Support](https://help.salesforce.com/s/articleView?id=ai.generative_ai_trust_lang_region.htm&release=264.0.0&type=5 "The Einstein Trust Layer detects and masks sensitive data such as personally identifiable information (PII) for multiple regions and languages.")