---
title: ES|QL TO_UPPER function
description: 
url: https://www.elastic.co/elastic/docs-builder/docs/3016/reference/query-languages/esql/functions-operators/string-functions/to_upper
products:
  - Elasticsearch
---

# ES|QL TO_UPPER function
## Syntax

![Embedded](https://www.elastic.co/elastic/docs-builder/docs/3016/reference/query-languages/esql/images/functions/to_upper.svg)


## Parameters

<definitions>
  <definition term="str">
    String expression. If `null`, the function returns `null`. The input can be a single-valued column or expression, or a multi-valued column or expression <applies-to>Elastic Stack: Generally available since 9.1</applies-to>.
  </definition>
</definitions>


## Description

Returns a new string representing the input string converted to upper case.

## Supported types


| str     | result  |
|---------|---------|
| keyword | keyword |
| text    | keyword |


## Example

```esql
ROW message = "Some Text"
| EVAL message_upper = TO_UPPER(message)
```


| message:keyword | message_upper:keyword |
|-----------------|-----------------------|
| Some Text       | SOME TEXT             |