Title Case

Text Processing String Manipulation

Synopsis

Converts strings to Title Case format.

Schema

- titlecase:
    field: <ident>
    target_field: <string>
    fields: <array>
    exclude: <array>
    preserve_articles: <boolean>
    description: <text>
    if: <script>
    ignore_failure: <boolean>
    ignore_missing: <boolean>
    on_failure: <processor[]>
    on_success: <processor[]>
    tag: <string>

Configuration

The following fields are used to define the processor:

Field	Required	Default	Description
field	N	-	Single field to convert to Title Case
target_field	N	Same as field	Target field to store Title Case result
fields	N	-	Array of fields to convert to Title Case
exclude	N	-	Array of fields to exclude from conversion
preserve_articles	N	false	Keep articles (a, an, the) lowercase except at start
description	N	-	Explanatory note
if	N	-	Condition to run
ignore_failure	N	false	Continue processing if conversion fails
ignore_missing	N	false	Skip processing if referenced field doesn't exist
on_failure	N	-	See Handling Failures
on_success	N	-	See Handling Success
tag	N	-	Identifier

Details

Converts string values to Title Case format by capitalizing the first letter of each word while keeping the rest lowercase. This format is commonly used for titles, headings, proper nouns, and display names.

The processor handles various input formats and applies proper Title Case rules, optionally preserving grammar rules for articles and prepositions.

note

Title Case format capitalizes the first letter of each significant word, resulting in format like "User Account Settings", "Data Processing Pipeline", or "System Configuration Value". This format is widely used for titles and headings.

When preserve_articles is enabled, common articles (a, an, the) and short prepositions (in, on, at, by, for, of, to, up) remain lowercase unless they appear at the beginning of the string.

warning

The processor treats any whitespace or punctuation as word boundaries. Hyphenated words will have each part capitalized (e.g., "real-time" becomes "Real-Time").

Examples

Basic Title Case

Converting text to Title Case format...	{ "page_title": "getting started with datastream processing" } - titlecase: field: page_title target_field: display_title
converts to Title Case:	{ "page_title": "getting started with datastream processing", "display_title": "Getting Started With Datastream Processing" }

Article Preservation

Preserving articles in proper grammar format...	{ "article_title": "the art of data processing in the modern age" } - titlecase: field: article_title preserve_articles: true target_field: formatted_title
keeps articles lowercase:	{ "article_title": "the art of data processing in the modern age", "formatted_title": "The Art of Data Processing in the Modern Age" }

Mixed Format Input

Converting mixed case input to proper Title Case...	{ "section_name": "USER-account_MANAGEMENT and Security" } - titlecase: field: section_name target_field: section_title
normalizes to Title Case:	{ "section_name": "USER-account_MANAGEMENT and Security", "section_title": "User-Account Management And Security" }

Multiple Fields

Converting multiple fields to Title Case...	{ "first_name": "john smith", "last_name": "doe williams", "job_title": "senior software engineer" } - titlecase: fields: ["first_name", "last_name", "job_title"]
processes all specified fields:	{ "first_name": "John Smith", "last_name": "Doe Williams", "job_title": "Senior Software Engineer" }

Menu Item Formatting

Formatting navigation menu items...	{ "menu_items": [ "home page", "user settings", "data analytics", "system administration" ] } - titlecase: field: menu_items target_field: formatted_menu
formats each menu item:	{ "menu_items": [...], "formatted_menu": [ "Home Page", "User Settings", "Data Analytics", "System Administration" ] }