Nik Custom Fields — Live Demo

In the editor

Single-line input. Placeholder, character limit, default value, prefix/suffix.

In the template

nik_the_field( 'd_text' );

In the editor

Multi-line plain text. Row count is a setting.

In the template

nik_the_field( 'd_textarea' );

In the editor

Numeric input with min, max, step and a prefix. Decimals are kept.

In the template

nik_get_field( 'd_number' );   // float
nik_the_field( 'd_number' );   // localised

In the editor

Slider with a live value readout.

In the template

nik_get_field( 'd_range' );

In the editor

Email input. An address that does not validate is rejected on save.

In the template

nik_the_field( 'd_email' );

In the editor

URL input.

In the template

nik_the_field( 'd_url' );

In the editor

Masked input. Stored verbatim, printed as dots.

In the template

nik_the_field( 'd_password' );

In the editor

The real WordPress editor: TinyMCE, Quicktags, media button. Shortcodes run on output.

In the template

nik_the_field( 'd_wysiwyg' );

In the editor

Dropdown. A value outside the configured list is refused.

In the template

nik_get_field( 'd_select' );

In the editor

Radio buttons.

In the template

nik_get_field( 'd_radio' );

In the editor

One choice, shown as a row of buttons.

In the template

nik_get_field( 'd_buttons' );

In the editor

A single tick box.

In the template

nik_get_field( 'd_checkbox' );   // bool

In the editor

On-off switch with its own label.

In the template

nik_get_field( 'd_truefalse' );  // bool

In the editor

Media library picker. Return format: id, URL, or the full array.

In the template

$img = nik_get_field( 'd_image' );
echo $img['sizes']['medium'];

In the editor

Several images, reorderable by dragging.

In the template

foreach ( nik_get_field( 'd_gallery' ) as $img ) {
    echo $img['sizes']['thumbnail'];
}

In the editor

Any attachment, not just images. Allowed extensions are a setting.

In the template

nik_the_field( 'd_file' );

In the editor

A dashicon or an image URL.

In the template

nik_the_field( 'd_icon' );

In the editor

A URL from any oEmbed provider; the embed is resolved on output.

In the template

nik_the_field( 'd_oembed' );

In the editor

URL, link text and an open-in-new-tab switch.

In the template

nik_the_field( 'd_link' );        // <a> with rel=noopener
nik_get_field( 'd_link' );        // array

In the editor

Native swatch plus a hex box.

In the template

nik_the_field( 'd_color' );

In the editor

Latitude, longitude and an address.

In the template

nik_the_field( 'd_map' );
nik_get_field( 'd_map' );

In the editor

Date only. Stored sortable, printed in the site format.

In the template

nik_get_field( 'd_date', false, false );  // raw
nik_the_field( 'd_date' );                // formatted

In the editor

Date with a time of day.

In the template

nik_the_field( 'd_datetime' );

In the editor

Time of day.

In the template

nik_get_field( 'd_time' );

In the editor

Search picker for one entry. Nothing is loaded until you type.

In the template

$post = nik_get_field( 'd_postobject' );
echo $post->post_title;

In the editor

Same picker, but the value is the permalink.

In the template

nik_the_field( 'd_pagelink' );

In the editor

Search picker for several entries, reorderable.

In the template

foreach ( nik_get_field( 'd_relationship' ) as $post ) {
    echo get_permalink( $post );
}

In the editor

Search picker over terms of any taxonomy.

In the template

nik_get_field( 'd_taxonomy' );

In the editor

Search picker over site users.

In the template

nik_get_field( 'd_user' );

In the editor

Several fields kept together under one name.

In the template

$d = nik_get_field( 'd_group' );
echo $d['w'] . '×' . $d['h'] . ' ' . $d['u'];

In the editor

Rows of subfields, added and reordered by the editor.

In the template

while ( nik_have_rows( 'd_specs' ) ) : nik_the_row();
    echo nik_get_row_index();
    echo nik_get_sub_field( 'name' );
    echo nik_get_sub_field( 'value' );
endwhile;

In the editor

A repeater inside a repeater. Nesting has no fixed limit.

In the template

while ( nik_have_rows( 'd_sections' ) ) : nik_the_row();
    echo nik_get_sub_field( 'title' );

    while ( nik_have_rows( 'items' ) ) : nik_the_row();
        echo nik_get_sub_field( 'label' );
    endwhile;
endwhile;

In the editor

The editor picks from named layouts, in any order, as many times as needed.

In the template

while ( nik_have_rows( 'd_flex' ) ) : nik_the_row();
    if ( 'hero' === nik_get_row_layout() ) { … }
endwhile;

In the editor

The fields of another group, reused without copying their configuration.

In the template

$a = nik_get_field( 'd_clone' );
echo $a['street'] . ', ' . $a['city'];

In the editor

Splits a long group into tabs in the editor. Holds no value.

In the template

// nothing to read

In the editor

Collapsible section in the editor. Holds no value.

In the template

// nothing to read

In the editor

A note shown to the editor. Holds no value.

In the template

// nothing to read