Plain Number Field

The Plain Number field is used to store numeric, integer, and float values.

Number input
Slider input

The Plain Number field can store numeric, integer, and float values. It has an upper limit of 64 digits and 30 decimals for storage.

Values are always stored without thousands separators and other formatting. For instance, a value like “1,203,303.29” would be stored in the database as “1203303.29”.

For currency numbers, you may want to use the Currency Field.

Quick Start

  1. Fill out the Basic Field Settings (Label, Description, and Field Name)
  2. Select Field Type: Plain Number.
  3. Click Save New Field (or Save Field if you’re updating an existing field) to save your field configuration.

Settings

  • Input Type
    The input type to use for the number. Available options are:
    • Freeform Number
    • Slider
  • Number Format
    The format the number will be displayed as. Available options are:
    • Localized Default
    • 1,234.00
    • 1234.00
    • 1.234,00
    • 1234,00
    • 1 234,00
    • 1’234.00
  • Decimals
    The number of decimals to allow. The upper limit in the database is 30 decimals.
  • Soft Formatting
    This will remove trailing decimals on display when they are “0”.
  • Slider Increment (Step)
    When using the Slider input, this is the increment used for each slider step.
  • Minimum Number
    When using the Slider input or HTML5 Number input, this is the minimum number to require on the input.
  • Maximum Number
    When using the Slider input or HTML5 Number input, this is the maximum number to require on the input.
  • Maximum Digits
    The maximum length of text to allow (default: 12), you can set it to -1 to disable the limit. However, the real upper limit in the database is 64 digits.
  • Enable HTML5 Input Field
    When enabled for a Number input (excluding Slider), this will render the field with type="number" using the default browser interface. Based on your needs, the browser interface may be a better experience especially for mobile devices. For more details on HTML5 types, you can read the documentation at W3 on Validating Common Input.
  • HTML Placeholder
    This is the text that will show on the input field when it is empty to help guide content entry. The placeholder is not a replacement for labels or description text, and it is less accessible for people using screen readers. For more details on the usage of Placeholder Text, you can read the documentation at W3 on Placeholders.

How to Display

Display with a Shortcode

[pods field="my_number_field"]

Display with PHP: pods_field_display()

<?php
echo pods_field_display( 'my_number_field' );

Display with PHP: $pod->display()

<?php
$pod = pods();

echo $pod->display( 'my_number_field' );

Other Helpful Documentation on Working with Fields in Pods

Avatar Field

Extends User Profile with a Gravatar field that is managed under the Media Library as opposed to using Gravatar.com

Code (Syntax Highlighting) Field

The Code (Syntax Highlighting) field is used for multiple line code content.

Color Picker Field

The Color Picker field is useful in situations where a color needs to be able to be chosen and customized.

Conditional Logic for Fields

Conditional Logic for Fields will allow you to show or hide a field based on the value of another field.

Currency Field

The Currency field is used to store numeric, integer, and float currency amounts.

Date / Time Field

The Date / Time field is used to store a date and time value with an easy to use date / time input.

Date Field

The Date field is used to store a date value with an easy to use date input.

Date time fields redirect

Email Field

The Email field allows you to store email addresses with additional validation checks.

File / Image / Video Field

The File / Image / Video field is used to store a relationship to Media attachment(s).

Heading Field

The Heading field is not a normal input field, it will output Heading text between your normal form fields to help organize the form.

HTML Content Field

The HTML Content field is not a normal input field, it will output as HTML itself between your normal form fields to help organize the form.

oEmbed Field

The oEmbed field is used to store a single URL that will use the oEmbed protocol to display remote content.

Password Field

The Password field is used to store single-line text with a basic password input form field.

Phone Field

The Phone field is used for telephone numbers in various formats.

Plain Paragraph Text Field

The Plain Paragraph Text field is used for multiple line text values.

Plain Text Field

The Plain Text field is used for Simple Plain Text Values like a first name, last name, alphanumeric ID or value.

Relationship Field

The Relationship field is used to store related items on various objects in WordPress.

Settings: Advanced

Provides access to the Advanced field options when editing a field.

Settings: Field Details

Basic Field Settings (Label, Name, Description and Field Type) that apply to all Fields created in Pods.

Settings: Reserved List of Names

There are certain names you cannot use for Pod, Group, or Field names in Pods because they are reserved in WordPress or Pods for other uses.

Simple Repeatable Fields

Simple Repeatable Fields will allow you to repeat many different types of fields.

Time Field

The Time field is used to store a date value with an easy to use time input.

Website Field

The Website field is used to store a URL or Website Address or Link to a Website.

WYSIWYG (Visual Editor) Field

The WYSIWYG (Visual Editor) field is used for multiple line HTML content.

Yes / No Field

The Yes / No field offers customizable labels and display options for checkbox, radio buttons, or a drop-down input.