Number

Type: number

Description

Numeric input field with optional min/max constraints.

Screenshot

Basic Usage

[
    "type" => "number",
    "heading" => __("Field Label", "your-text-domain"),
    "param_name" => "your_param_name",
    "value" => 0,
    "settings" => [
        "min" => 0,
        "max" => 100,
        "step" => 1,
    ],
    "description" => __("Field description", "your-text-domain"),
]

Common Parameters

All param types support these common parameters:

Parameter	Type	Description
type	String	Required. Must be "number"
holder	String	HTML tag name where the value is displayed in backend edit mode. Default: hidden input
class	String	CSS class added to the holder HTML tag
heading	String	Label shown in the editor interface
param_name	String	Required. Parameter name used in shortcode
value	Mixed	Value for the parameter
description	String	Help text shown below the field
group	String	Tab/group name to organize parameters
section	String	Section slug to visually group params within a tab
weight	Integer	Display order (higher = shows first)
edit_field_class	String	CSS class for field width (e.g., "vc_col-sm-6")
dependency	Array	Show/hide based on other field values
admin_label	Boolean	Show value in element title bar
param_holder_class	String	CSS class for the param wrapper in the edit element modal
save_always	Boolean	Force saving the value even if it equals the default or is empty
callback	Array	JavaScript function callback (e.g., ['after_add' => 'myCallback'])
settings	Array	Type-specific configuration options (see Type-Specific Parameters below)
deprecated	String	Version in which the param was deprecated

Type-Specific Parameters

Parameter	Type	Default	Description
settings	Array	-	Configuration array with the following options:
min	Integer	-	Minimum allowed value
max	Integer	-	Maximum allowed value
step	Integer	-	Step increment value
placeholder	Integer	-	Placeholder value shown when empty
units	Boolean|Array	false	Enable CSS unit selector. Set to true for default units (px, em, rem, vw, vh, %) or provide a custom array (e.g., ['px', 'em', '%']). When enabled, the saved value includes the unit suffix (e.g., "10px")
default_unit	String	First unit in list	The unit selected by default when no unit is present in the value

Complete Example

<?php
add_action('vc_before_init', 'my_element_with_number');
function my_element_with_number() {
    vc_map([
        "name" => __("My Element", "domain"),
        "base" => "my_element",
        "category" => __("My Category", "domain"),
        "params" => [
            [
                "type" => "number",
                "heading" => __("Items Count", "domain"),
                "param_name" => "items_count",
                "value" => 10,
                "settings" => [
                    "min" => 0,
                    "max" => 100,
                    "step" => 5,
                ],
                "description" => __("Number of items to display", "domain"),
            ],
            [
                "type" => "number",
                "heading" => __("Margin Top", "domain"),
                "param_name" => "margin_top",
                "value" => "20px",
                "settings" => [
                    "min" => 0,
                    "max" => 200,
                    "step" => 1,
                    "units" => ['px', 'em', '%'],
                    "default_unit" => 'px',
                ],
                "description" => __("Top margin with unit selector", "domain"),
            ],
        ],
    ]);
}