Loading

"Error: Custom Setting Name too long" error in Custom Settings Name field when Double-byte characters are used

Julkaisupäivä: Apr 2, 2026
Kuvaus

When using some double-byte text strings in Custom Settings Name field that are‌ much shorter than 38 characters, "Error: Custom Setting Name too long" error still happens.

Custom Settings is a Salesforce feature that allows administrators to create custom data sets and associate them with an organization, profile, or user. Double-byte characters are characters used in languages such as Chinese, Japanese, and Korean, where each character requires two bytes of storage rather than the single byte used by standard ASCII characters. This error typically appears when an admin or developer creates a Custom Setting and enters a name using double-byte characters that visually appears well under the 38-character limit. The unexpected behavior occurs because Salesforce internally converts the double-byte string into ASCII format using the Java toASCII() method before applying the limit — and that conversion can cause the string length to increase non-linearly, meaning a short-looking input can exceed 38 characters after conversion.



Ratkaisu

When double-byte characters such as Chinese or Japanese are used in the Custom Settings Name field, Salesforce converts the string to ASCII using the Java toASCII() method before applying the 38-character limit. Because this conversion can increase string length non-linearly, even short double-byte strings may exceed the limit.


If double-byte texts are used in Custom Settings field, consider making the text strings shorter.

As per Define Custom Settings

"The name can't exceed 38 ASCII characters. If you use double byte, there are additional limits on the number of characters allowed."

When double-byte characters are used, the string is converted into ASCII characters by using JAVA method toASCII() . The 38-character limit is then applied to the converted ASCII string.
As the converted string's length can increase nonlinearily, a relatively short input string could potentially be converted to strings longer than 38-characters.

It is recommended to check a given string's converted length by using JAVA For example:
        //Within limit
        System.out.println(java.net.IDN.toASCII("一二三四五六七八九十壹贰三").length());
        //Exceeding limit
        System.out.println(java.net.IDN.toASCII("一二三四五六七八九十壹贰三四").length());

Certain online JAVA Complier tools such as tutorialspoint.com can be conveniently utilized.

Knowledge-artikkelin numero

000397067

 
Ladataan
Salesforce Help | Article