Text.Proper

Text

Capitalizes the first letter of each word in a text value.

Examples on this page use shared sample tables. View them to understand the input data before reading the examples below.

Syntax

Text.Proper(text as nullable text, optional culture as nullable text) as nullable text

Parameters

NameTypeRequiredDescription
texttextYesThe text value to convert to proper case.
culturetextNoA culture code (e.g., "en-US") that determines locale-specific casing rules.

Return Value

textThe input text with the first letter of each word capitalized and the rest lowercased.

Remarks

Text.Proper converts text to title case — the first letter of each word is capitalized and the remaining letters are lowercased. This is ideal for cleaning up names and titles that have inconsistent casing.

Note that Text.Proper treats any non-letter character as a word boundary, so hyphens, apostrophes, and other punctuation trigger capitalization of the next letter.

Examples

Example 1: Proper case employee names

Table.TransformColumns(
    Table.SelectColumns(Employees, {"FullName"}),
    {"FullName", Text.Proper, type text}
)
Result
FullName
1Alice Smith
2Bob Jones
3Charlie Brown
4Diana Prince
5Eve Martinez
6Frank Lee

Compatibility

Power BI Desktop Power BI Service Excel Desktop Excel Online Dataflows Fabric Notebooks