Every field has a label and a name. The label is what editors read. The name is what your code uses. Confusing the two is the commonest reason a template returns nothing.
What It Does
The name is generated from the label when you first create the field, then stops following it. Rename the label afterwards and the two diverge, which is deliberate: renaming the name would orphan every value already saved against it.
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.
Find a Field Name
- Go to Nexter → Content Fields and open your field group.
- Click Edit on the field.
- Read the Field Name box. That exact string is what you pass to the template functions.
- The field list also shows the name in its own column, so you can read them all at once.
When to Use It
- Writing a template call and needing the exact selector.
- Auditing which names a group actually uses.
- Renaming a label for editors without breaking the front end.
Display the Value
The name, not the label, is the selector:
<?php
// Field Label: "Property reference"
// Field Name: reference
echo esc_html( nxt_field_value( 'reference' ) );Limitations
- A field name must be a single word: letters, numbers, underscores and dashes, no spaces.
- Changing a field name after values exist orphans those values. The old name keeps the data; the new name starts empty.
Troubleshooting
My template returns nothing
You are almost certainly passing the label. Open the field and copy the Field Name exactly.
I renamed a field and values vanished
Renaming the name points the field at a different meta key. Rename it back to recover, or migrate the values with a one-off script.
