A link field stores a complete link — the URL, the text shown, and whether it opens in a new tab — as one value, using the same link picker as the block editor.
What It Does
Rather than asking editors to fill three separate fields, the link field captures all three parts together and hands them to your template as one value.
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 Link 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 Book a viewing. The Field Name fills in automatically and is what you use in code.
- Set Field Type to Link.
- Set Return Value — the whole link, or just the URL.
- 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 Value | No help text in the UI. |
Validation
| Setting | Options | What it does |
|---|---|---|
| Required | No help text in the UI. |
Presentation
| Setting | Options | What it does |
|---|---|---|
| Instructions | 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 call-to-action on a listing or landing page.
- An external profile or source link.
- A booking or enquiry link that differs per post.
Display the Value
With the full link returned, render the anchor yourself and escape every part:
<?php
$link = nxt_field_value( 'viewing' );
if ( ! empty( $link['url'] ) ) {
printf(
'<a href="%s" target="%s">%s</a>',
esc_url( $link['url'] ),
esc_attr( ! empty( $link['target'] ) ? $link['target'] : '_self' ),
esc_html( ! empty( $link['title'] ) ? $link['title'] : $link['url'] )
);
}Limitations
- The link value is stored as a structure, so it is not exposed through the WordPress REST API by default.
- A link field holds one link. For a list, use a repeater with a link sub-field.
Troubleshooting
I only get a URL string
Return Value is set to URL only. Switch it to the full link if you need the title and target as well.
The link opens in the same tab despite choosing a new tab
The target is stored on the value, but your template has to apply it — see the example above. Nothing renders the anchor for you.
