Unicode is a character encoding standard designed to support characters of the world’s languages.
The following recommendations will help you avoid issues when working with Unicode characters in ReadyAPI:
Open Settings and go to Time & Language:
Go to Region & language and click Administrative language settings:
On the Administrative tab, click Change system locale:
Select the needed locale and apply the changes.
Set the -Dfile.encoding=UTF8
system property.
The way you do this depends on how you run ReadyAPI. See Modifying JVM Settings.
![]() |
Open Preferences > Editor.
In the Editor font and Text Field font options, specify fonts that support the needed Unicode characters.
Unicode symbols in the names of the following test items may cause issues:
Projects
Test suites
Test cases
Security tests
Load tests
Virtual services
We recommend that you avoid using Unicode characters in their names.
When you send requests containing Unicode characters set the encoding property to UTF-8. To do this:
Open a request.
Set the Encoding property to UTF-8.
![]() |
It is also possible to make ReadyAPI set the Unicode encoding for all the requests. To do this, set the -Dsoapui.request.encoding=UTF-8
system property. The way you do this depends on how you run ReadyAPI. See Modifying JVM Settings.
In some cases, the Normalize line-break option may cause issues with Unicode characters in your project. To turn off the option:
Open Preferences > UI.
Deselect the Normalize line-break option.
![]() |
Currently, ReadyAPI has a number of limitations related to Unicode characters:
ReadyAPI does not show Unicode characters in the following panels:
Test item properties
ReadyAPI logs
Assertions
Grid data source
ReadyAPI does not support emoji symbols.
When ReadyAPI cannot show Unicode characters correctly, it displays "rectangle"
symbols:

The issue affects only displaying characters. ReadyAPI does not modify any strings.