the_attachment_link( int|WP_Post $id, bool $fullsize = false, bool $deprecated = false, bool $permalink = false )

Display an attachment page link using an image or icon.

Parameters

$id

(int|WP_Post) (Optional) Post ID or post object.

$fullsize

(bool) (Optional) Whether to use full size.

Default value: false

$deprecated

(bool) (Optional) Deprecated. Not used.

Default value: false

$permalink

(bool) (Optional) Whether to include permalink.

Default value: false

More Information

Outputs an HTML hyperlink to an attachment file or page, containing either

  1. A full-size image or thumbnail for image attachments; or
  2. The attachment’s title (as text) for non-image attachments

If no attachment can be found, the function displays the string Missing Attachment.

Use wp_get_attachment_link() instead if you just want to get the hyperlink, not print it.

Source

File: wp-includes/post-template.php 

function the_attachment_link( $id = 0, $fullsize = false, $deprecated = false, $permalink = false ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '2.5.0' );
	}

	if ( $fullsize ) {
		echo wp_get_attachment_link( $id, 'full', $permalink );
	} else {
		echo wp_get_attachment_link( $id, 'thumbnail', $permalink );
	}
}

Uses

Uses Description
wp-includes/functions.php: _deprecated_argument()

Mark a function argument as deprecated and inform when it has been used.
wp-includes/post-template.php: wp_get_attachment_link()

Retrieve an attachment page link using an image or icon, if possible.

Changelog

Version Description
2.0.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/the_attachment_link