An image field lets an editor pick a picture from the media library, or upload a new one, without touching the post content. The image belongs to the post as data, so a template decides how it is displayed.
What It Does
The image field stores a reference to a media library attachment. What it hands back to your template depends on Return Format — an attachment ID, a URL, or an array with the sizes and alt text.
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 an Image Field
- Go to Nexter → Content Fields and open the Group Fields tab.
- Open a field group, or create a new one.
- Click Add Field.
- Set Field Label to Hero photo. The Field Name fills in automatically and is what you use in code.
- Set Field Type to Image.
- Choose a Return Format — see the table below.
- Set Library if editors should only pick from images they uploaded themselves.
- Click Update.
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
| Setting | Options | What it does |
|---|---|---|
| Return Format | No help text in the UI. | |
| Library | No help text in the UI. |
Validation
| Setting | Options | What it does |
|---|---|---|
| Required | No help text in the UI. | |
| Allowed File Types | No help text in the UI. |
Presentation
| Setting | Options | What it does |
|---|---|---|
| Instructions | No help text in the UI. | |
| Preview Size | thumbnail, medium, medium_large, large, 1536x1536, 2048x2048 | No help text in the UI. |
| Wrapper Attributes | No help text in the UI. |
Conditional Logic
| Setting | Options | What it does |
|---|---|---|
| Conditional Logic | No help text in the UI. |
When to Use It
- A hero photo on a property or product.
- A logo on a client or partner entry.
- A portrait on a team member.
Display the Value
With Return Format set to ID, let WordPress render a responsive, correctly sized image:
<?php
$id = nxt_field_value( 'hero' );
if ( $id ) {
echo wp_get_attachment_image( $id, 'large' );
}Limitations
- An image field holds one image. For a set of images, use a repeater with an image sub-field.
- Deleting the attachment from the media library leaves the field pointing at an ID that no longer resolves — always check the value before rendering.
Troubleshooting
The field returns a number instead of an image
That is the attachment ID, which is what Return Format is set to. Either pass it to wp_get_attachment_image() as above, or change Return Format to URL.
Nothing renders on the front end
The attachment may have been deleted. Check the value is non-empty before rendering, and confirm the field name in your template matches the Field Name shown in the builder — not the label.
