# Text

## Text Value

### String

The most basic but most often used text block is below. You can type into this text block, or leave it empty.

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2Fybw4wVlJHMl8gHFCnuue%2Ftext-str.png?alt=media\&token=95a61843-aafc-41b0-ba4d-d01acd76298a)

### Join

Often, you'll want to join text values together with the `join` block:

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FurbHeEXNVOAOlHx7PKi8%2Ftext-join.png?alt=media\&token=f6411f40-b268-4592-9b59-591110000526)

### Newline

You can use the `newline` block to add a line break in a piece of text.

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MJWI5X5jP9bkWrMzdya%2F-MJWI9weiKw3MImXY3aY%2Ftextblocks%20newline.png?alt=media\&token=a6a168f5-7a63-4811-9f64-7f273e18c45f)

## Reformat Text

Use these blocks to change the content or formatting of your text. These blocks will return the reformatted text.

### Set case

Set a piece of text to the selected case:

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FWWhTo5C00mcrHTPnmtFX%2Ftext-case.png?alt=media\&token=917ebf8a-d69a-4c3e-a517-44dc4447e37e)

### Trim Spaces

Trim blank spaces from the left side, the right side, or both sides of a string of text:

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FYqAniGndipGbBud8ejn3%2Ftext-trim.png?alt=media\&token=80f78e30-57d1-4b5b-844f-eb6ba057d596)

### Replace all

Find and replace all occurrences of a substring within a string.

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MJWIPO3KnSS0WmL2LIB%2F-MJWJZ0ez6_JbHEvLqj8%2Ftextblocks%20replace.png?alt=media\&token=a5061e5a-ba8e-4582-860c-91f7ecdd7d37)

## Analyze Text

### Is Empty

The block below tests whether the text value is empty. Returns `true` or `false`

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FQ43LlKb1hFrNYINY4QB9%2Ftext-empty.png?alt=media\&token=f17e1330-4879-4ad3-9206-deebbb617195)

### Get letter

Returns the character at the specified position, where 1 is the first letter of the string.\
Returns the empty string if the length of text given is less than the position specified.

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FTR97XW9kXrBADqxmFLVy%2Ftext-get%3Better.png?alt=media\&token=a0880728-f74b-4499-8de6-0326beab007b)

### Get substring

Returns the substring at the specified start and end position, where 1 is the first letter of the string.\
Returns the empty string if the length of text given is less than the starting position specified.

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2F0IWfYnvMwrOddOi5CINO%2Ftext-substr1.png?alt=media\&token=f8bfbae4-1402-46af-a15c-01b46f36b7ec)

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2Fj6ob4LaSxT27FzhcyLL6%2Ftext-substr2.png?alt=media\&token=5542b0a1-467c-44c2-bd8b-46a63c8333ec)

### Find first/last occurrence

Returns the starting position of a substring within a string, where 1 is the first letter of the string.\
Returns 0 if the string does not contain the substring.

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FGHD36aWehquCx0esM4r1%2Ftext-first.png?alt=media\&token=48064af3-2ac9-4fa4-aa92-e055ab4696b6)

### Does string contain

Checks if a string contains a substring. Returns `true` or `false`. 

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MJWIPO3KnSS0WmL2LIB%2F-MJWJ4McB0hDZMaujH8M%2Ftextblocks%20does%20contain.png?alt=media\&token=88f3faf7-6820-4135-9e8a-f5ceaaf4e544)

### Get length of string

Returns length of a given string as a number

![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FL7dAOdwSkb4SoiIzfDSF%2Ftext-length.png?alt=media\&token=793308a2-903a-4d8d-999c-70947d8d4c1f)