# Insert Field

This action allows you to insert any field (standard or custom) retrieved from the Master Object, User Object, Record Variable, or Runtime Variable.

> Kind: Guide · Updated: Jul 31, 2026

This action allows you to insert any field (standard or custom) retrieved from the Master Object, User Object, Record Variable, or Runtime Variable.

To insert data from the following:
- Master Object: The source record selected at the start, containing all its fields.
- User Object: Holds context of the user generating the document / running the flow.
- Record Variable: Holds a record and its field values, created by selecting an object type and setting conditions.
- Runtime Variable: Stores a value for reuse or modification, using field or constant values with an optional default.

## Follow the steps below to insert a field:

- Select Insert Field from the Select Action drop-down menu.
- Choose the desired field from the drop-down menu.
- Master Object fields are listed under "Record" (Global Variables).
- User Object fields are listed under "User" (Global Variables).
- Record Variables appear under "Variable".
- Runtime Variables and constants are listed under "Global Constants".

- Click Insert to place the field at the cursor's location in the work area. You can also copy and paste inserted fields as needed.

## Formatting Options:

Text: You can choose to capitalize (first letter in uppercase), use lowercase, or uppercase for the text.

![](https://media.help.cloudfiles.io/dg-insert-field-sf/01.png)

Font: All inserted fields can be formatted like regular text in Word, including changes to font, size, and style.

Date Formatting: Date and datetime fields have a Format dropdown with four presets and a Custom option.

![](https://media.help.cloudfiles.io/dg-insert-field-sf/02.png)

| Option | Output |
|---|---|
| Short | 08/23/2024 |
| Medium | Aug 23, 2024 |
| Long | August 23, 2024 |
| Full | Friday, August 23, 2024 |
| Custom | Any pattern you define |

Select Custom when you need a time component, a non-US date order, or a format the presets do not cover.

- Set Format to Custom.
- Enter a pattern in the Pattern box, such as MMM dd, yyyy.
- Check the Preview line below the box. It shows your pattern applied to a sample date, so you can confirm the output before inserting.
- Click Insert.

![Custom date pattern with live preview in the Insert Field panel](https://media.help.cloudfiles.io/dg-insert-field-sf/date-custom-preview.png)

Select Tokens next to Pattern to see every supported token with an example of its output.

![Supported date format tokens with meanings and examples](https://media.help.cloudfiles.io/dg-insert-field-sf/date-format-tokens.png)

Separators such as /, -, , and spaces are printed exactly as you type them.

> **Tokens are case sensitive.** — MM is the month and mm is minutes, so dd/mm/yyyy prints the minutes value where you expect the month. Use dd/MM/yyyy. Pair hh with a so a 12 hour time shows AM or PM.

Patterns accept tokens and separators only. Literal words are not supported, and single quotes do not work as escape characters, so a pattern such as dd 'of' MMMM will not produce the result you expect.

Number Formatting: Number, currency, and percent fields accept a format pattern that controls decimal places, separators, and any currency symbol. Enter the pattern in the Format box.

![](https://media.help.cloudfiles.io/dg-insert-field-sf/upload-f2d78120.png)

A pattern describes a shape, not an example value. Only four characters control the number:

| Character | What it does |
|---|---|
| 0 | Always shows a digit. Inserts a zero if the value has none. |
| # | Shows a digit only if the value has one. |
| , | Thousands separator. |
| . | Decimal separator. |

Anything else you type, such as $, £, or GBP, is printed as-is around the number.

How decimals behave

Characters after the . set the maximum number of decimal places, and the value is rounded half-up to fit. 0 and # then decide whether each digit is shown.

- .00 always shows two decimals. 9,503.1 prints as 9,503.10.
- .## shows up to two decimals and drops trailing zeros. 9,503.10 prints as 9,503.1, and 10,000.00 prints as 10,000.

The same logic applies before the decimal point. With ###,###.##, a value of 0.89 prints as .89 because the leading zero is dropped. Ending the whole number part with 0, as in #,##0.00, always keeps at least one digit.

Recommended patterns

| Use case | Pattern | Value | Output |
|---|---|---|---|
| Currency | £#,##0.00 | 9503.11 | £9,503.11 |
| Currency | £#,##0.00 | 10000 | £10,000.00 |
| Whole numbers | #,##0 | 1234.6 | 1,235 |
| Percent, field stores 0.1234 | 0.00% | 0.1234 | 12.34% |
| Percent, field stores 12.5 | 0.00\% | 12.5 | 12.50% |

Use 0 for every digit you want guaranteed. For currency, £#,##0.00 is almost always the correct pattern.

A % placed after the digits multiplies the value by 100 before printing. Salesforce percent fields already store 12.5 rather than 0.125, so write the sign as \% to print it without multiplying.

Other separator styles

Always write the pattern with , for grouping and . for decimals. To print a different convention such as 1.234.567,89, set the Group Separator and Decimal Separator dropdowns below the Format box. These change the printed characters only. The pattern itself stays in standard notation.

Go to 0:27 to see the Insert Field action being used to create a sample receipt in Microsoft Word.

[Watch video](https://youtu.be/yR75QbsCFc8?t=20)