SmartAI supports multiple languages to help you serve customers from anywhere in the world. You can change the chat and admin interface language, or even add your own translations.
๐ฌ Chat Language Options
SmartAI chat is already translated into 41 languages!
You can choose how the system picks the language for users.
โ Language Options:
| Option | Description |
| Option 1 | Set to Multilingual under Settings > Chat > Language. It will auto-detect the user’s browser or saved profile language. |
| Option 2 | Add ?lang=xx to the chat script URL to force a specific language. Replace xx with the two-letter code (e.g., es for Spanish). |
| Option 3 (WordPress only) | Go to Settings > WordPress > Force Language to fix the language site-wide. |
| Option 4 (WordPress only) | Chat uses your WordPress site’s default language, or the language of the page (if your site uses WPML or Polylang). |
๐ก Language Codes Example:
- Spanish: es
- French: fr
- Simplified Chinese: zh
- Traditional Chinese: zt
- Brazilian Portuguese: pt
๐งโ๐ป Admin Language
You can also set the language of the admin interface (dashboard).
Options to Set Admin Language:
- Auto Translate Admin Panel
Enable this under Settings > Admin > Automatically translate admin area. It uses the agent’s browser or profile language. - Manual Setup (Advanced)
(Not for Cloud version)
Add this code to config.php:
php
CopyEdit
define(‘SB_ADMIN_LANG’, ‘es’);
Replace ‘es’ with the two-letter code of your preferred language.
โ๏ธ Translate Custom Content
You can manually translate almost everything โ rich messages, built-in messages, chat headers, and more.
How to Translate Custom Text:
- Go to Settings > Translations > New translation.
- Enter the original English text in the first field.
- Add your translation in the second field.
- Use \n to add line breaks.
๐ก You can also use AI-powered auto-translation if the Artificial Intelligence app is installed.
โ Add a New Language
You can add a completely new language to the system.
How to Add:
- Open this folder:
supportboard/resources/languages/front/ - Duplicate the file source.json.
- Rename the new file with your language code (e.g., hi.json for Hindi).
- Go to Settings > Translations โ your new language will now appear.
To add language for the admin area, repeat the steps in the admin folder instead of front.
๐ก๏ธ Good news: Your custom languages wonโt be deleted during updates!
๐ Troubleshooting Tips
- If a string is missing: click Add new translation in Settings > Translations.
- Remove extra spaces or line breaks for broken translations.
- Edits are saved in files, not the database. A backup is created in the uploads folder.
- Some symbols (like &) are replaced by safe HTML characters (e.g., &).
