Link

Documentation Field Types Link

Last updated Feb 17, 2022

Description

The Link field allows a link to be selected or defined (url, title, target) by using the native WordPress link popup.

Screenshots

Changelog

• Added in version 5.6.0.

Settings

• Return value
  Specifies the format of the returned data. Choose from Link Array (array of data) or Link URL (string).

Template usage

The Link field will return either an array or string depending on the return value setting. Below are some examples of how you can use this data.

Basic Display (array)

This example demonstrates how to display the selected link when using the Link Array return type.

<?php 
$link = get_field('link');
if( $link ): 
    $link_url = $link['url'];
    $link_title = $link['title'];
    $link_target = $link['target'] ? $link['target'] : '_self';
    ?>
    <a class="button" href="<?php echo esc_url( $link_url ); ?>" target="<?php echo esc_attr( $link_target ); ?>"><?php echo esc_html( $link_title ); ?></a>
<?php endif; ?>

Basic display (string)

This example demonstrates how to display the selected link when using the Link URL return type.

<?php 
$link = get_field('link');
if( $link ): ?>
    <a class="button" href="<?php echo esc_url( $link ); ?>">Continue Reading</a>
<?php endif; ?>

Related

• Content: File
• Content: Image
• Field Types: Page Link
• Choice: Button Group
• Choice: Radio Button