---
title: "FORM Butler NUMERIC form-field"
description: "[https://www.youtube.com/watch?v=vZV-4kPBAqg](https://www.youtube.com/watch?v=vZV-4kPBAqg) FORM Butler can convert a merge field in a Word document into an **editable numeric field**. Use a NUMERIC form field when the value should always be a number, such as a number of locations. ### Step 01: Prepare…"
url: "https://pdfbutler.com/academy/form-butler-academy/form-butler/form-butler-numeric-form-field-2/"
updated: "2026-10-30"
category: FORM BUTLER
---

# FORM Butler NUMERIC form-field

[https://www.youtube.com/watch?v=vZV-4kPBAqg](https://www.youtube.com/watch?v=vZV-4kPBAqg)

FORM Butler can convert a merge field in a Word document into an **editable numeric field**. Use a NUMERIC form field when the value should always be a number, such as a number of locations.

### Step 01: Prepare the Word Document

1. Open the Word document you want to use with FORM Butler.
2. Add the merge field that will become editable if it is not already present in the Word document. The same merge-field syntax used with PDF Butler can be used when creating the FORM Butler document.

![](https://pdfbutler.com/wp-content/uploads/2023/08/01_step01_number_of_locations_merge_field.webp)

**In this example, the document contains a Number of Locations merge field.**

**Note:** If your FORM Butler Doc Config, document upload, and required DataSources are not already set up, complete the **FORM Butler Document and DataSource Setup** guide before continuing. 

If the configuration already exists, review the current DataSources and add any additional DataSource required for the field you are configuring. After adding a new DataSource, click **Save to Server** before continuing.

![](https://pdfbutler.com/wp-content/uploads/2023/08/02_step01_note_save_to_server_datasource-1.webp)

### Step 02: Configure the Field as a NUMERIC Form Field

1. On the left-hand side, click **Add Config Type**.

![](https://pdfbutler.com/wp-content/uploads/2023/08/03_step02_click_add_config_type-1.webp)

1. Enter a name for the field you want to configure. Use the same name as the corresponding merge field in the Word document. Then change the configuration type from **Single**to **Single for Form Fields**.

![](https://pdfbutler.com/wp-content/uploads/2023/08/04_step02_name_and_single_for_form_fields-1.webp)

1. In **Datasource**, select the data source that contains the field you want to use.
2. In **DataSourceField**, select the specific Salesforce field that should supply the value.
3. In **MergeField**, enter the merge field from your Word document that should be linked to that Salesforce field.

![](https://pdfbutler.com/wp-content/uploads/2023/08/05_step02_datasource_number_of_locations_field.webp)

**In this example, the Number of Locations field is used from the Account data source.**

### Step 03: Configure the NUMERIC Form Field Settings

You can now use the **Form Field Data** options to configure the field as a numeric input.

1. Leave **Lock when data** unchecked if users should be able to edit the value after the document is generated.
2. Set the **Control type** to **Single Line Input**.

![](https://pdfbutler.com/wp-content/uploads/2023/08/06_step03_control_type_single_line_input-1.webp)

1. Choose the preferred measurement unit for the form field dimensions. Then set the width and height of the form field.
2. Set **Validation Type** to **Numeric Value**. Use this validation type when the field should only accept a numeric value. Then click **OK**.

![](https://pdfbutler.com/wp-content/uploads/2023/08/07_step03_validation_type_numeric_value.webp)

**In the example, the field is set to approximately 106 mm wide and 8 mm high.**

### Step 04: Save and Test the NUMERIC Form Field

1. Click **Save to Server**. Confirm that the configuration validates successfully.
2. Generate a preview document to verify that the numeric field appears correctly and is populated as expected.

![](https://pdfbutler.com/wp-content/uploads/2023/08/08_step04_save_and_test_numeric_preview.webp)