Shows the left X-most characters from the original token. Spaces are included in the character count. X=6 in this example:

Original token: Now is the winter of our discontent

Modifier: Left (6)

Result: Now is


Left(str, length)

Enabled For

For a description of the business object categories, see Notes on "Enabled For".

Business Object Category Yes/No
Business Rules: Before-Save Rules Yes
Business Rules: Calculation Rules (After Save, with or without Also Recalculate on Load) Yes1
Business Rules: Calculation Rules (Before Save or Always, without Also Recalculate On Load) Yes
Business Rules: Calculation Rules (Before Save or Always, with Recalculate On Load) Yes1
Business Rules: Editing Rules Yes
Business Rules: Initialization Rules Yes
Business Rules: Read Only Rules Yes
Business Rules: Required Rules Yes
Business Rules: Validation Rules Yes
Client Expressions Yes
Object Permissions No
Services No
Mobile No
Quick Actions (except UI Quick Actions) Yes
UI Quick Actions Yes
Reports Yes
Search/Dashboard without field references No
Search/Dashboard with field references No

1. Not fully supported in calculation rules that have a condition of After Save or the Also Recalculate on Load option selected. It may fail if the rule's field is used in a grid, form, or saved search.


Parameter Description
str Input string to find left most characters for a given length


Number of characters to show from the input string start from the left of the string

Return Value

Returns the characters from left of the input string until a given length.


$(Left("Now is the winter of our discontent", 6))


Returns this value: Now is