The Number field allows a user to enter a number. The field then automatically validates the form data to insure that a number was entered. You can also set a minimum and maximum number and the field will validate that the entered data is within that range.


Number General

  • Field Label
    Enter the label of the form field. This is the field title the user will see when filling out the form.

  • Description
    Enter the description for the form field. This will be displayed to the user and provide some direction on how the field should be filled out or selected.

  • Number Format
    Select the format of numbers that are allowed in this field. You have the option to use a comma or a dot as the decimal separator.

  • Range
    Enter the minimum and maximum values for this form field. This will require that the value entered by the user must fall within this range.

  • Enable Calculation
    Enabling calculations will allow the value of this field to be dynamically calculated based on a mathematical formula.

  • Rules
    These properties set rules for how the data should be handled.

    • Required
      A required field will prevent the form from being submitted if it is not filled out or selected.
    • No Duplicates
      A field set to allow no duplicates will require that a value entered in a field does not currently exist in the entry database for that field.


Number Appearance

  • Placeholder
    Displayed to provide a hint to the user of the expected input.

  • Description Placement
    Determines where the description will be located, in relation to the field.

  • Custom Validation Message
    If you would like to override the default error validation for a field, enter it here. This message will be displayed if there is an error with this field when the user submits the form.

  • Custom CSS Class
    Enter the CSS class name you would like to use in order to override the default styles for this field.

  • Field Size
    Select a form field size from the available options. This will set the width of the field.


Number Advanced

  • Admin Field Label
    Enter the admin label of the form field. Entering a value in this field will override the Field Label when displayed in the Gravity Forms administration tool.

  • Default Value
    If you would like to pre-populate the value of a field, you can specify a static value or select a variable value from the predefined list.

  • Visibility
    Select the visibility for this field. Field visibility set to Everyone will be visible by the user submitting the form. Form field visibility set to Admin Only will only be visible within the Gravity Forms administration tool. Setting a field to Admin Only is useful for creating fields that can be used to set a status or priority level on submitted entries.

  • Allow field to be populated dynamically
    Check this option to enable data to be passed to the form and pre-populate this field dynamically. Data can be passed via Query Strings, Shortcode and/or Hooks.

  • Enable Conditional Logic
    Create rules to dynamically display or hide this field based on values from another field. Remember, to use conditional logic, you will need to create a drop down, checkbox or multiple choice field.

Merge Tags


{Field Name:2:modifier}


  • :value
    Tells the merge tag to not use a thousands separator, and instead use the numeric value of the field.

Last modified: October 4, 2017