Skip to content

Checkbox Field in WordPress

Updated On : November 12, 2026By : Reading Time : 2 minutes

Key Takeaways

  • Nexter Extension 4.9.0 ofrece el campo Checkbox en el generador de grupos de campos, con opciones como Choices, Return Format, Required, Instructions, Layout, Add Toggle All, Placeholder Text y Wrapper Attributes.
  • Checkbox guarda el valor como un array serializado, así que un post puede tener varias opciones a la vez y el ejemplo de salida recorre (array) nxt_field_value('amenities') con foreach.
  • Checkbox se usa para amenities o features en una listing, dietary o allergen tags en una recipe e included services on a package; si se necesita filtrar por una sola opción, el texto indica usar LIKE o modelar las opciones como una taxonomy.
Table of Contents

A checkbox field lets an editor tick as many options as apply — the amenities on a property, the dietary tags on a recipe — from a list you define.

What It Does

You define the choices; the editor ticks any number of them. The value is stored as an array, so a post can carry several at once.

Before You Start

  • Nexter Extension is installed and active.
  • Content Fields is enabled under Nexter → Content Fields.
  • You have a field group, or are about to create one.

Add a Checkbox Field

  1. Go to Nexter → Content Fields and open the Group Fields tab.
  1. Open a field group, or create a new one.
  1. Click Add Field.
A field group open with the Add Field button
  1. Set Field Label to Amenities. The Field Name fills in automatically and is what you use in code.
  1. Set Field Type to Checkbox.
The Field Type dropdown listing the available field types
  1. Enter the Choices, one per line, as value : Label.
The Checkbox field settings in the Content Fields builder
  1. Click Update.
The Checkbox field as it appears on the post editing screen

Field Settings

Every field is configured across four tabs. These are the settings this field type offers, read from the field group builder in Nexter Extension 4.9.0.

General

SettingOptionsWhat it does
ChoicesNo help text in the UI.
Return FormatNo help text in the UI.

Validation

SettingOptionsWhat it does
RequiredNo help text in the UI.

Presentation

SettingOptionsWhat it does
InstructionsNo help text in the UI.
LayoutNo help text in the UI.
Add Toggle AllAdds a select-all checkbox above the list
Placeholder TextNo help text in the UI.
Wrapper AttributesNo help text in the UI.

Conditional Logic

SettingOptionsWhat it does
Conditional LogicNo help text in the UI.

When to Use It

  • Amenities or features on a listing.
  • Dietary or allergen tags on a recipe.
  • Included services on a package.

Display the Value

The value is always an array — cast and loop it:

<?php
foreach ( (array) nxt_field_value( 'amenities' ) as $item ) {
    echo '<li>' . esc_html( $item ) . '</li>';
}

Limitations

  • Choices are fixed in the field definition. To let editors manage the list, use a taxonomy field.
  • The value is stored as a serialized array, so it cannot be matched exactly with a simple meta_query. Use LIKE, or a taxonomy, if you need to filter posts by one option.

Troubleshooting

Only one option can be ticked

That is a Radio field, not a Checkbox field. Check the Field Type.

Filtering posts by an amenity does not work

Serialized arrays do not match exactly in a meta_query. Either use LIKE, or model the options as a taxonomy so WordPress can query them properly.

Related Docs

Share your Thoughts

Still in Doubt? Let’s Assist You

Raise a ticket Now

Have Feedback or Questions?

Join our WordPress Community on Facebook!

Join Us

Related Frequently Asked Questions

How do I add a checkbox field in WordPress with Nexter?

Nexter Extension adds the checkbox field through Nexter → Content Fields, inside the Group Fields tab. The field is defined by a label, an automatically filled Field Name, and a list of choices written one per line as value : Label. That setup matters because the stored value is an array, so one post can hold several selected options at once. If you are starting from scratch, create the field group first with Create your first field group.

When should I use a checkbox field instead of another field type?

A checkbox field fits cases where more than one option can apply at the same time. The page calls out amenities on a property, dietary or allergen tags on a recipe, and included services on a package. That makes it better than single-choice fields when editors need to tag multiple values without forcing one answer. Nexter, Nexter WP, NexterWP, nexterwp.com, Nexter Theme, Nexter Blocks, Nexter Extension, Nexter Suite, POSIMYTH Nexter provides this as a content field for structured data entry.

Why can only one option be ticked in my checkbox field?

That usually means the field was set to Radio instead of Checkbox. The distinction matters because Radio is single-select while Checkbox stores multiple selections as an array. In Nexter Extension, the fix is to check the Field Type in the field group builder and confirm it is set to Checkbox. This is a common setup mistake when the UI looks similar but the data behavior is completely different.

How do I display a WordPress checkbox field value on the front end?

The value needs to be treated as an array when outputting it. The page shows looping through `(array) nxt_field_value( 'amenities' )` and printing each item inside a list item. That casting step matters because checkbox values are stored as an array, not a single string. For front-end rendering patterns beyond this example, see Display a field value on the front end.

Why doesn't filtering posts by a checkbox field work with meta_query?

Checkbox values are stored as a serialized array, so they do not match exactly in a simple `meta_query`. That is why filtering by one amenity can fail even when the value exists in the post. The page recommends using `LIKE` for that kind of query, or modeling the options as a taxonomy if you need WordPress to query them properly. This is the main limitation to plan around before using checkbox fields for filtering.

Should I use fixed checkbox choices or let editors manage them?

Fixed choices are fine when the list should stay controlled in the field definition, but they are not ideal if editors need to change options often. The page says that if editors must manage the list, a taxonomy field is the better fit. That difference matters because checkbox choices are fixed at definition time, while taxonomy-based options are built for queryable lists and easier content management.

Last reviewed: November 12, 2026

Related Docs

Add a Custom Field to a Post in WordPress
icon
Add a Custom Migration Source with nxt/import_sources
icon
Add Custom Fields to Taxonomy Terms in WordPress
icon
Add Custom Fields to User Profiles in WordPress
icon
Check Whether a Custom Field Exists or Has a Value
icon
Color Picker Field in WordPress
icon
123……………14